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Liebe Leser, 


wenn Sie diese Ausgabe des Microsoft System Journals aufmerksam durchblättern, werden Ihnen 
sicherlich einige Veränderungen auffallen. So kümmern wir uns nicht mehr nur allein um die Soft- 
ware, sondern berichten auch über Hardware - sofern diese im direkten Zusammenhang mit der 
Softwareentwicklung steht. 


Das ist allerdings nur der Anfang der Umgestaltung, die mit der nächsten Ausgabe - mit der wir 
übrigens das zweijährige Bestehen des Microsoft System Journals feiern - erst richtig losgeht. 


Dann nämlich werden wir Sie mit einem neuen gefälligeren Layout und einem Umfang von 140 
bis 160 Seiten überraschen. Außerdem wird in jedem Heft nicht nur die Diskette mit den Pro- 
grammlistings, sondern auch ein C-Programmierkurs enthalten sein. Sollten Sie die Programmdis- 
kette bisher abonniert haben, wird Ihnen das Restguthaben auf den Abo-Preis für die Zeitschrift 
angerechnet. 


Und damit das Microsoft System Journal nicht nur eine Zeitschrift für Insider bleibt, wird der 
Vogel Verlag den Vertrieb auch über Kiosk und Fachbuchhandel vornehmen. Natürlich können Sie 
das Microsoft System Journal auch weiterhin abonnieren bzw. Ihren Kollegen und Bekannten zum 
Abonnement empfehlen. Daß Sie das bisher schon ausgiebig praktiziert haben, merken wir an der 
ständig wachsenden Leserschaft. 


Dafür ein herzliches Dankeschön! 


Christian Wedell 
Geschäftsführer der Microsoft GmbH 


Juli/August 1989 Microsoft System Journal 3 


Ausgabe Juli/August 1989 


Semi JoummAı. 


Microsoft Windows 

Die Mehrfachdokumentenschnittstelle .................. 5 
CD-ROM 

Das Gigabyte-Zeitalter ..........umssseussenneosonnssonnee 34 


CDs von Microsoft: Bookshelf und 
PORT ST IREBIN eännerianrneen 36 


MS 08/2 


Vom Regen in die Sonne: 
Mostiate Unter OSJ2. „ss 38 


Die 1/O-Subsysteme von OS/2 .....uuua 50 


6 


Eine Help-Engine für Ihre 
SIIERDORENIEEN ee 71 


Das nese QUKKE 2 nein 92 


Rubriken 


7 en EEENEENESEENEER 
WERERURER nenne 
Buchbesprechungen er 
Sn 151 21 I EEEEFEREGDREEM 
DDR. user 
Inserentenverzeichnis .................s0s00siscnse 80 


4 Microsoft System Journal 


Die Mehrfachdokumentenschnittstelle (Multiple Document Inter- 
face, MDT) ist der kommende Standard einer Benutzerschnittstelle 
für Microsoft Windows und den OS/2-Presentation Manager, die 
die Darstellung mehrerer Tochterfenster innerhalb des Applika- 
tionsfensters ermöglicht. 


Informationen werden in steigendem Maß zu einem Wirtschafts- 
faktor. In den USA ist man sich des enormen Wettbewerbsvorteils 
durch komprimierte Datenbanken mehr bewußt als in Europa, 
weshalb die CD-ROM dort ein verbreitetes Speichermedium ist. 


Microsoft bietet mit seinen CD-Produkten Bookshelf und der 
Programmer’s Library Schlüsselprodukte in diesem Bereich an. 
Wir beschreiben, was sie zu bieten haben. 


Wir stellen mit BILDOS2, mit dem OS/2-Textbildschirme auf 
Knopfdruck gespeichert werden können, die Möglichkeit vor, 
unter OS/2 TSR-ähnliche Programme zu realisieren. 


OS/2 enthält I/O-Services für Tastatur, Videodisplay und Maus, 
die bei der Implementierung einer OS/2-Benutzerschnittstelle 
besonders wichtig sind. Ed Iacobucci, der Chefentwickler für OS/2 
bei IBM, beschreibt in diesem Artikel diese 1/O-Subsysteme. 


Das Handbuch im Rechner zählt nicht erst seit dem SAA-Stan- 
dard zu den Leistungsmerkmalen, an denen sich jede PC-Appli- 
kation messen lassen muß. Im Rahmen dieser Folge unserer SAA- 
Serie stellen wir eine universelle Help-Engine vor, die einfach in 
jede Applikation eingebunden werden kann. 


Immer mehr Programmierer sind dazu übergegangen, ihre Pro- 
gramme in C zu entwickeln; damit ist auch die Nachfrage nach 
leistungsfähigen und vor allem komfortablen Entwicklungsumge- 
bungen gewachsen. Microsoft kommt diesem Trend entgegen, 
indem es dem Programmierer mit QuickC 2.0 eine Entwicklungs- 
umgebung an die Hand gibt, die keine Wünsche mehr offen läßt. 


Die Termine des Microsoft-Instituts 

Neue Soft- und Hardware, Aktuelles 
Nachschlagewerke über Computer und Software 
Der ferngesteuerte Computer mit Carbon Copy Plus 
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Der kommen tandard zur Handhabung von D 


mentfenstern: 


Die Mehrfachdokumentenschnittstelle (MDI) 


Die Mehrfachdokumentenschnittstelle (im engli- 
schen Multiple Document Interface, im folgen- 
den MDI genannt) ist eine Benutzerschnittstelle 
für Microsoft Windows und den OS/2-Presenta- 
tion Manager (im folgenden PM genannt), die 
die Darstellung mehrerer Tochterfenster inner- 
halb des Applikationsfensters ermöglicht. Jedes 
dieser kleineren Tochterfenster kann zur An- 
zeige unterschiedlicher Daten oder zur unter- 
schiedlichen Anzeige gemeinsamer Daten ver- 
wendet werden. 


Dieser Artikel beschreibt MDI, wobei sowohl auf die 
Benutzerschnittstelle (Bild I) als auch auf die Programmie- 
rung dieses Standards eingegangen wird. In diesem Zusam- 
menhang wird eine Windows-Bibliothek mit Namen 
MDILIB beschrieben, die die einfache Einbindung von 
MDI in Ihre eigene Applikation ermöglicht. Die Anwen- 
dung der Bibliothek wird anhand einer einfachen Applika- 
tion (COLORS.EXE) gezeigt. Schließlich wird der MDI- 
Standard der »Systems Application Architecture« (SAA) 
und der einheitlichen Benutzeroberfläche »Common User 
Access« (CUA) von IBM gegenübergestellt und verglichen. 


Hintergrund und Motivation 


Windows- und PM-Entwickler sind schon seit langer Zeit 
fasziniert von Applikationen, die Fenster innerhalb anderer 
Fenster darstellen. Diese Begeisterung beruht einerseits auf 
den physikalischen Fähigkeiten der Hardware und wird 
auch durch andere Fenstersysteme beeinflußt. MDI kann 
deshalb als weitere Verbesserung dieser Idee angesehen 
werden, indem versucht wurde, unter Windows eine Umge- 
bung mit gemeinsamen Menüs zu erzeugen. Nachdem die 
Arbeit an diesem Standard beendet ist und erhebliche Ver- 
änderungen in die Windows-Oberfläche gebracht hat, wird 
MDI nun auf den OS/2-PM übertragen. 

In gewissem Maße erfüllt MDI nicht nur die prinzipiel- 
len Anforderungen der Entwickler, sondern andererseits 
wird dadurch auch die Funktionsweise von Mehrfachfen- 
stern auf IBM-kompatiblen PCs festgelegt. Zusätzlich 
erleichtert die Spezifikation die Entwicklung einer neuen 
Generation von Applikationen mit ähnlicher Schnittstelle 
auf Apple Macintosh, Windows und OS/2-PM. 

Von Beginn an wurde die MDI-Spezifikation mehrfach 
verbessert und erweitert (vorwiegend von Microsoft), um 
sie mit CUA in Einklang zu bringen. Das Ergebnis war die 
formale Definition von MDI im Handbuch des Microsoft 
Windows Software Development Kit (SDK), gefolgt von der 
Verwendung in Microsoft-Excel - der ersten Applikation 
mit MDI-Oberfläche. 

Dem Vorbild Microsoft-Excel folgend haben viele Soft- 
ware-Entwickler versucht, mehrfache Tochterfenster in ihre 
Applikationen einzubauen, aber unglücklicherweise gelang 
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Bild 1: Microsoft-Excel verwendet die Mehrfach-Dokumen- 
ten-Schnittstelle. 


es nur wenigen, die Originalspezifikation von MDI vollstän- 
dig zu implementieren. Dies kommt daher, daß es ziemlich 
schwierig ist, MDI korrekt zu implementieren, da dies ein 
detailliertes und tiefgreifendes Verständnis der zugrundelie- 
genden Systemumgebung erfordert. Weiterhin benötigt die 
Implementierung von MDI bei Windows eine Reihe raffı- 
nierter Tricks, die an schlechten Programmierstil zuminde- 
stens erinnern. 

Ungeachtet dieser Schwierigkeiten wurde die Akzeptanz 
von MDI durch das neue (nach meiner Auffassung nicht 
sehr gut durchdachte) OS/2-Dateisystem (siehe Bild 2) 
weiter gefestigt. Verbunden mit dem neuen und auch konsi- 
stenteren PM-Programmiermodell wird dies wahrscheinlich 
seine Anziehungskraft sowohl auf Entwickler als auch auf 
Software-Vertreiber vergrößern. 


Definition und Spezifikation 


Von Anfang an muß klargestellt werden, daß MDI die Dar- 
stellung einer Benutzerschnittstelle ist, was bedeutet, daß 
MDI nicht eine Menge fester Implementierungsregeln be- 
inhaltet, sondern eine Sammlung von Richtlinien darstellt. 
Obwohl sich viele Entwickler bei der Implementierung von 
MDI an diese Richtlinien halten, haben nur wenige MDI 
auf die gleiche Weise implementiert. 

Das erste, was man bei MDI verstanden haben muß, 
besteht darin, daß es ein oberstes Fenster gibt, das Haupt- 
fenster der Applikation. Dieses Fenster ist immer in der 
Größe veränderbar, besitzt eine Titelzeile im Kopf, ein 
Steuermenüfeld und Sinnbildfelder zum Verkleinern und 
Vergrößern des Fensters. Meistens enthält die Titelleiste 
des Hauptfensters nur den Namen der Applikation (mehr 
dazu weiter unten). Wie bei den meisten anderen Fenstern 
auch, kann das Steuerungsmenü mit den Abkürzungstasten 
auf der folgenden Seite bedient werden. 


Microsoft System Journal 5 


| ee | selects a drive 


| 


Bild 2: Das OS/2-Presentation-Manager-Dateisystem basiert 
auf MDI. 


Wiederherstellen Bit)(F5) 
Bewegen 
Größe ändern 
Sinnbild 
Vollbild Gut)[FI2) 
Schließen GER) 


Dieses Hauptfenster zeigt auch die Menüleisten an, die 
den einzelnen vorhandenen Tochterfenstern zugeordnet 
sind. Die Menüleiste verändert sich je nachdem, welches 
der Tochterfenster gerade aktiv ist. Wechselt beispielsweise 
der Benutzer von einem Tochterfenster, welches ein Dia- 
gramm darstellt, zu einem anderen, welches ein Rechen- 
blatt der Tabellenkalkulation beinhaltet, verändert sich im 
Hauptfenster die Menüleiste, um nun die Menübefehle des 
neuen aktiven Fensters anzuzeigen. Einige Menüeinträge 
können gleichbleiben, unabhängig davon, welches Fenster 
gerade angewählt wurde. So haben beispielsweise Datei- 
oder Formatierbefehle die gleiche Bedeutung in Fenstern 
mit unterschiedlichem Kontext. 

Weiterhin enthält die Menüleiste des Hauptfensters ein 
weiteres Menü zum Verwalten der Tochterfenster. Die 
Befehle in diesem Menü sind unabhängig davon, welches 
Fenster gerade ausgewählt ist. Somit kann der Benutzer mit 
diesem Menü die Anordnung der Tochterfenster im 
Hauptfenster einstellen. Im ersten Teil des Menüs befinden 
sich Befehle, welche Größe, Position und Sichtbarkeit des 
Tochterfensters behandeln. Im zweiten Teil befindet sich 
eine Liste aller (auch als Sinnbild) sichtbaren Fenster. Mei- 
stens sieht dieses Menü ungefähr so aus wie in Bild 3. 

Der Befehl »Neu« ermöglicht dem Benutzer, eine wei- 
tere Abbildung des augenblicklich ausgewählten Doku- 
ments anzuzeigen. Hierzu wird ein neues Tochterfenster 
erzeugt, welches ebenfalls das ausgewählte Dokument ent- 
hält. Obwohl dies nicht immer sinnvoll ist, ist es dann nütz- 
lich, wenn ein Benutzer verschiedene Ansichten eines Do- 
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Nebeneinander 
Immer Nebeneinander 


Verbergen... 
Anzeigen... 


1. Fenster! 
2. Fenster2 
3. Fenster3 


Bild 3: Ein aufgeschlagenes MDI-Standard-»Fenster«-Menü. 


kuments gleichzeitig betrachten möchte. Es könnte be- 
spielsweise dazu verwendet werden, verschiedene Ver- 
größerungen einer Zeichnung in einem Grafikprogramm 
anzuzeigen: Ein Fenster enthält die gesamte Zeichnung, ein 
anderes einen vergrößerten Ausschnitt der Zeichnung. 

Obwohl der vorhandene Bildschirm von der Größe 
meist ziemlich beschränkt ist, bieten die meisten MDI- 
Implementierungen einige Mechanismen zur Anordnung 
der verschiedenen Tochterfenster an. In der Implementie- 
rung in diesem Artikel folgen dem »Neu«-Befehl zwei 
weitere Befehle, die die Anordnung der Tochterfenster 
erleichtern helfen. 

Der Befehl »Nebeneinander« legt alle sichtbaren Toch- 
terfenster in den Zeichenbereich des Hauptfensters. Ob- 
wohl viele gute Algorithmen zur Anordnung denkbar sind, 
verfahren die meisten Implementierungen derart, daß sie 
dem augenblicklich angewählten Tochterfenster eine höhe- 
re Prioriät zuordnen und ihm den meisten Platz zuweisen. 
Zu beachten ist, daß der »Nebeneinander«-Befehl wie bei 
den meisten Implementierungen nur zum Zeitpunkt seines 
Aufrufens die Fenster nebeneinander legt. Spätere Ver- 
schiebungen der Tochterfenster zerstören die Anordnung 
wieder. 

Der Befehl »Immer Nebeneinander« ist eine Erweite- 
rung des »Nebeneinander«-Befchls. Er bewirkt, daß die 
Tochterfenster auch in Zukunft nebeneinander stehen blei- 
ben. Wird die Größe eines Tochterfensters verändert, ver- 
ändern sich die Größen der anderen Fenster so, daß sie 
wieder nebeneinander liegen. Irgendwelche Änderungen 
beim Mutterfenster oder eines der Tochterfenster bewir- 
ken, daß die Tochterfenster sich wieder neu anordnen (wie 
dies beim früheren Windows mit Version 1.03 erfolgte). 
Obwohl diese Option nicht bei anderen wichtigen Windows- 
oder PM-Applikationen verwendet worden ist, hat sie eine 
Reihe von Vorteilen, die ihre Verwendung ernsthaft recht- 
fertigt. 
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Bild 4: Der Standard-Menübefehl »Verbergen« ist Teil des 
MDI-»Fenster«-Menüs. 


Professionelle Anwender arbeiten oft mit mehreren 
gleichzeitig geöffneten Dokumenten, was zu einer unüber- 
sichtlichen Benutzeroberfläche führt. Deshalb folgen den 
»Nebeneinander«-Befehlen zwei Befehle, die das Ver- 
bergen oder das Wiederanzeigen eines oder mehrerer 
Dokumentfenster ermöglichen. Der »Verbergen«-Befehl 
bewirkt, daß das zuletzt vom Benutzer selektierte Tochter- 
fenster verborgen wird (siche Bild 4). Eine weitverbreitete 
Variante des Befehls ermöglicht dem Benutzer gleichzeitig 
mehrere Fenster zu verbergen, indem diese in einem Ver- 
zeichnisfeld innerhalb eines Dialogfelds gleichzeitig ausge- 
wählt werden. Dadurch kann der Benutzer mit einem 
Handgriff einen Großteil der Darstellung verschwinden las- 
sen. 

Wenn Fenster verborgen sind, existieren sie weiterhin, 
es kann auf sie aber nicht zugegriffen werden. Mit Hilfe des 
Befehls »Anzeigen« kann der Benutzer über das Verzeich- 
nis der verborgenen Fenster eines oder mehrerer davon 
wieder sichtbar machen. Die Fenster werden an die alte 
Position in ihrer ursprünglichen Größe wieder angeordnet 
oder, wenn die Option »Immer Nebeneinander« eingeschal- 
tet ist, in die Fensteranordnung hineingeschoben und diese 
entsprechend korrigiert. 

Die letzte Gruppe von Einträgen im Menü »Fenster« 
besteht aus einer Liste aller zur Zeit abgebildeten Fenster. 
Die Fenster sind mit ihren Titelnamen aufgeführt, wobei 
jedem Namen eine Ziffer vorangeht, die als Abkürzungs- 
taste verwendet wird. Dies ermöglicht einen schnellen und 
einheitlichen Zugriff auf jedes Tochterfenster über die 
Tastatur, unabhängig vom gegenwärtigen Namen. Wenn 
eines der Fenster in der Liste aktiv ist, wird dies durch eine 
Markierung vor dem Namen angezeigt. 

In einigen Applikationen können bestimmte Befehle nur 
dem Hauptfenster zugeordnet sein. In diesem Fall wird der 
Titelname des Hauptfensters am Beginn der Liste aufge- 
führt. Dies ermöglicht dem Benutzer einen einfachen 
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Bild 5: Das Dialogfeld »Anzeigen«. 


Zugriff auf die Befehle des Hauptfensters. Applikationen, 
die diese Variante nicht benötigen, können den Namen des 
Hauptfensters in der Fensterliste weglassen. 


Tochterfenster 


Nachdem der Begriff des Hauptfensters klar geworden ist, 
muß man sich mit den Tochterfenstern auseinandersetzen, 
die durch MDI verknüpft sind. Wie das Hauptfenster, so ist 
jedes der Tochterfenster in der Größe veränderbar und 
enthält eine Titelleiste. Diese enthält normalerweise den 
Namen des Dokuments, das über das Fenster bearbeitet 
wird. Wird ein einzelnes Dokument in mehr als einem 
Tochterfenster angezeigt, wird an den Dokumentnamen 
eine Durchzählnummer angehängt, etwa: 


CHART.XLC: 1 
CHART.XLC:2 
CHART.XLC:3 


Nur ein Tochterfenster kann zu einem bestimmten Zeit- 
punkt aktiv sein und dieses unterscheidet sich von den ande- 
ren Tochterfenstern durch die abweichende Farbe in der 
Titelleiste, genauso wie sich gewöhnlich das aktive Haupt- 
fenster von anderen Applikations-Hauptfenstern unter- 
scheidet. Zu beachten ist, daß das Hauptfenster aktiv bleibt, 
wenn eines der Dokumentfenster aktiviert wird. In gewisser 
Hinsicht ist dies ein sichtbarer Widerspruch, da der Einga- 
befokus gleichzeitig zwei Fenstern zugewiesen zu sein 
scheint. Er sagt noch nichts darüber aus, welche Purzel- 
bäume Sie beim Programmieren schlagen müssen, um dies 
zu realisieren. 

Das aktive MDI-Tochterfenster enthält auch ein Steuer- 
menü. Obwohl es so ähnlich wie das des Mutterfensters 
benutzt wird, erfolgt der Aufruf über die Tastenkombina- 
tion (Alt)[-) (ich bin mir nicht ganz klar, welcher tieferlie- 
gende Grund sich dahinter verbirgt). Die Befehle im 
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Bild 6: Ein Tochterfenster in Vollbild-Darstellung. Der Name 
des Tochterfensters wurde in die Titelleiste von Microsoft 
Excel integriert. 


Steuermenü des Tochterfensters entsprechen denen des 
Hauptfensters, außer daß bei den Abkürzungstasten die 
(Alt)-Taste durch die [Strg)-Taste ersetzt wurde. Als Ergeb- 
nis erhält man ein Steuermenü, das die folgenden Einträge 
besitzt: 


Wiederherstellen Gtrz)[F5) 
Bewegen 
Größe ändern 
Sinnbild 
Vollbild enlan 
Schließen Strg) FR) 


Es ist Aufgabe der Applikation, die ungeeigneten Ein- 
träge zu sperren oder grau anzuzeigen. Bei den meisten 
Implementierungen wird nur der »Sinnbild«-Befehl ge- 
sperrt. 

Die Befehle »Bewegen« und »Größe ändern«, ange- 
sprochen über und [Strg)[F8), erlauben die Posi- 
tion und Größe des Tochterfensters zu ändern. Die Funk- 
tionalität entspricht den entsprechenden Befehlen der 
Hauptfenster, aber ihre Ausdehnung ist bei Tochterfenstern 
auf den Fensterinhalt des Hauptfensters beschränkt. Wie 
bei den meisten Befehlen kann das Bewegen oder das 
Ändern der Größe eines Tochterfensters auch mit der 
Maus durchgeführt werden. 

Ein interessantes Detail ist, wie der Fensterrahmen dar- 
gestellt wird, wenn das Fenster bewegt wird. Obwohl die 
Mausaktivitäten auf den Fensterinhalt des Hauptfensters 
beschränkt bleiben, kann der Bewegungsrahmen des Fen- 
sters auch außerhalb der Grenzen des Mutterfensters 
betrachtet werden. Bei der PM-Implementierung von MDI 
wird auch dieser Rahmen vom System am Rande des 
Hauptfensterinhalts abgeschnitten. 

Der Befehl »Sinnbild« ((Stre)(F9)), nur selten bei Win- 
dows implementiert, verkleinert das Tochterfenster zu 
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einem Sinnbild, das innerhalb des Hauptfensterinhalts ange- 
zeigt wird. Das erhaltene Sinnbild kann ausgewählt, inner- 
halb des Hauptfensters bewegt und wieder zur ursprüng- 
lichen Größe und Position umgewandelt werden. In Über- 
einstimmung mit allen sichtbaren Tochterfenstern des 
MDI-Hauptfensters kann das Sinnbild verborgen oder über 
die Liste im »Fenster«-Menü ausgewählt werden. Zu 
beachten ist, daß während dieses Prozesses das Sinnbild 
innerhalb des Fensterinhalts des Hauptfensters stehen muß 
und nicht außerhalb davon auf dem Bildschirm bewegt 
werden darf. Beim OS/2-PM ist dies relativ einfach zu 
realisieren, bei Windows dagegen steigt dadurch weiter die 
Komplexität der MDI-Implementierung an und deshalb 
sind MDI-Implementierungen mit Tochterfenster-Sinnbil- 
der ziemlich selten. Beim OS/2-PM ist dies dagegen erheb- 
lich leichter zu implementieren, und ich erwarte, daß mehr 
Applikationen in der MDI-Implementierung die Vorteile 
dieser Fähigkeit nutzen werden. Wenn Sie neugierig sind, 
wie dies bei OS/2 gemacht wird, schen Sie sich die Beispiel- 
Applikation WITHIN im MS-OS/2-Software-Development- 
Kit (OS/2-SDK), Version 1.1 an. 

Der Befehl »Vollbild« ((Strg)[F1#)) bewirkt, daß das 
MDI-Tochterfenster so vergrößert wird, daß es den gesamt- 
en Fensterinhalt des Hauptfensters ausfüllt (siehe Bild 6). 
Als Abkürzung kann auch die Maus verwendet werden und 
damit das Vollbild-Sinnbild angeklickt oder die Titelleiste 
doppelt anklickt werden. 

Wenn der Fensterinhalt des Tochterfensters das 
Hauptfenster ausfüllt, kann man sich vorstellen, daß sich die 
Titelleiste des Tochterfensters unter die Menüleiste des 
Applikationsfensters »schiebt«. Dann geschehen zwei wei- 
tere Dinge: Das erste betrifft die Titelleiste des Hauptfen- 
sters. Ursprünglich enthält sie nur den Applikationsnamen. 
Aber wenn ein Tochterfenster als Vollbild dargestellt wird, 
wird die Titelleiste des Applikationsfenster so geändert, daß 
sie den Namen des aktuellen Dokuments enthält, wie es bei 
normalen Applikationen ohne MDI üblich ist. Zweitens, 
und dies ist vielleicht sogar die kompliziertere Änderung, 
wird das Steuermenü des Tochterfensters an den Beginn 
der Applikations-Menüleiste gesetzt. Dadurch ist weiterhin 
der Zugriff auf das Tochterfenster-Steuermenü möglich, um 
es zu schließen oder auf die ursprüngliche Größe zu ver- 
kleinern. 

Wenn Sie denken, daß diese Dinge schon kompliziert 
genug sind, sollten Sie noch bedenken, was passiert, wenn 
ein neues MDI-Tochterfenster angelegt oder ein bereits 
existierendes ausgewählt wird, während ein anderes ein 
Vollbild ist. Die MDI-Spezifikation schreibt vor, daß bei der 
Auswahl eines anderen Fensters oder beim Neuanlegen 
dieses Fenster automatisch die Charakteristik des vorher 
selektierten besitzt. Dies beinhaltet auch, daß beim Neuan- 
legen eines Fensters während der Vollbild-Darstellung 
eines anderen auch das neue Fenster als Vollbild dargestellt 
wird. Ähnlich verhält es sich beim Schließen eines Vollbild- 
Fensters: Die MDI-Applikation wählt automatisch das 
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Wähle nächstes Unterfenster (im Uhrzeigersinn) 


Wähle vorheriges Unterfenster (im Gegenuhr- 


zeigersinn) 

Wähle nächstes Tochterfenster (vom ersten zum 
letzten) 

Wähle vorheriges Tochterfenster (vom letzten zum 
ersten) 


Tabelle 1: Standard-MDI-Abkürzungstasten 


nächste verfügbare Tochterfenster aus und vergrößert es für 
Sie - ob Sie nun wollen oder nicht. 

Mit dem »Wiederherstellen«-Befehl ((Strg)[F5)) wird, 
wie Sie erwarten dürften, das Fenster aus seiner Vollbild- 
Darstellung (oder seiner Sinnbild-Darstellung, sofern 
implementiert) in seine ursprüngliche Größe und Position 
zurückgewandelt, zusammen mit den anderen Fenstern. 
Auch das Steuermenü wandert wieder an seinen alten Platz. 

Schließlich zerstört der »Schließen«-Befehl ((Stra)[F#)) 
das aktuell ausgewählte Tochterfenster. In Situationen, in 
denen das Tochterfenster eine von mehreren Ansichten 
eines gemeinsamen Dokuments darstellt, werden die Titel- 
leisten der übrigbleibenden Fenster automatisch neu durch- 
numeriert, um die Veränderung anzuzeigen. Wenn das 
Tochterfenster das letzte Fenster ist, das auf das Dokument 
zugreift, wird üblicherweise ein Dialogfeld angezeigt, das 
nachfragt, ob Änderungen gesichert werden sollen. Wie bei 
allen Steuermenüs ist das doppelte Anklicken des Steuer- 
menüfelds eine Abkürzung für die Auswahl des »Schlie- 
Ben«-Befehls. 

Eine andere Sache, die bei all den beschriebenen Befeh- 
len beachtet werden sollte, ist, daß diese sich nur auf das 
augenblicklich aktive Tochterfenster beziehen. Das bedeu- 
tet auch, daß nur dieses Fenster ein Steuermenü und Felder 
für Vollbild oder Sinnbild besitzt. Unglücklicherweise geht 
dies aus der ursprünglichen MDI-Spezifikation nicht ganz 
klar hervor. Als abschließendes Ergebnis muß jedes der 
Tochterfenster seine Darstellungsattribute ändern, wenn es 
den Eingabefokus erhält oder entzogen bekommt. 

Als wäre dies noch nicht genug, enthält die MDI-Spezi- 
fikation auch noch eine Liste von Abkürzungstasten für den 
Wechsel zwischen verschiedenen Tochterfenstern (siehe 
Tabelle I). Trotz der Tatsache, daß diese Tasten nicht im 
Steuermenü des Tochterfensters aufgeführt worden sind, 
sind sie der einzige Mechanismus für den Wechsel zwischen 
Tochterfenstern ohne Verwendung der Maus. Es bleibt den 
Benutzern überlassen (vorausgesetzt sie lesen die Doku- 
mentation), sich zu erinnern, daß es diese Tasten gibt und 
was sie bedeuten. Schließlich ist auch die Umsetzung dieser 
Abkürzungstasten eine weitere Aufgabe des bereits ziemlich 
überladenen MDI-Hauptfensters. 
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Bild 7: Microsoft Excel, nachdem alle Tochterfenster verbor- 
gen wurden. Die meisten Menüs sind verschwunden und der 
Menü-Befehl »Anzeigen« ist jetzt Bestandteil des »Datei«- 
Menüs. 


Entwurfs-Aspekte 


Bevor wir auf die eigentlichen Programmier-Aspekte ein- 
gehen, die aus der MDI-Implementierung resultieren, 
scheint es angebracht, die Entwurfs-Aspekte zu diskutieren, 
die auftauchen, wenn man sich mit der Spezifikation 
beschäftigt. Der vielleicht vordergründigste Aspekt ist die 
zusätzliche Komplexität, die mit der Verwendung von MDI 
einhergeht. Wenn Sie nicht inzwischen ein eigenes Konzept 
besitzen, werden Sie viel Zeit benötigen, bis MDI imple- 
mentiert ist und korrekt funktioniert. Vom Entwurfsstand- 
punkt her fordert MDI, daß jedes Tochterfenster in seinem 
Aufbau objektorientiert ist (also seine eigenen Daten unab- 
hängig verwaltet), dennoch kann es Zugriffe auf gemein- 
same Daten geben, wenn mehrere Ansichten eines Objekts 
stattfinden. Weiterhin bewirkt der Standard einige Auswir- 
kungen auf die Performance, da er zusätzliche Verwaltun- 
gen und eine weitere Hierarchie-Ebene in dem System ein- 
führt. 

Es liegt auch auf der Hand, als Alternative mehrere 
Instanzen von eng verbundenen Applikationen mit einer 
MDI-Implementierung zu vergleichen. Positiv ist, daß eine 
Gruppe von unabhängigen Applikationen oft leichter zu 
entwerfen, implementieren und zu testen ist, insbesondere 
wenn die Umgebung die Aspekte der Datenverwaltung 
überwacht. Dieser Ansatz ist insbesondere dann erfolgreich, 
wenn nicht Windows-spezifische Applikationen verwendet 
werden oder der Einfluß jener auf die Umgebung unter 
günstigsten Umständen gering ist. 

Negativ ist, daß sich ein unübersichtlicher Bildschirm- 
inhalt ergibt, sich keine Konsistenz mit der Benutzerober- 
fläche des Apple-Macintosh herstellen läßt und die Schwie- 
rigkeit, eine gut integrierte Interprozeß-Kommunikation 
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Bild 8: Wenn ein Tochterfenster nicht mehr im Fensterinhalt 
des Hauptfensters steht, kann dennoch über die Tastatur dar- 
auf zugegriffen werden. Allerdings treten einige merkwürdige 
Effekte auf. Beispielsweise erscheint das Steuermenü des 
Tochterfensters »einsam« ohne Bezug auf dem Bildschirm. 


zwischen unabhängigen Applikationen zu schaffen. Weiter- 
hin erfordern viele Applikation die mehrfache Betrachtung 
eines einzelnen Dokuments und somit ist die MDI-Imple- 
mentierung etwas, über das Sie einmal nachdenken sollten. 

Ein weiteres lästiges Feld beim Entwickeln ist die Art, 
wie MDI mit Menüs umgeht. Obwohl Menüs ziemlich ein- 
fach zu strukturieren sind, wenn jedes Tochterfenster 
homogen in seiner Beschaffenheit ist und gleiche oder ähn- 
liche Fähigkeiten gemeinsam nutzt, kann der Entwurf kom- 
pliziert werden, wenn Tochterfenster schr heterogen sind 
oder sich auf verbundene Dokumente bezichen. 

Der Menü-Entwurf ist weiterhin dann kompliziert, wenn 
das Applikationsfenster leer ist oder alle Tochterfenster 
verborgen wurden. Die meisten der normalen Menüein- 
träge werden dann ungültig und für den Benutzer uninteres- 
sant, Viele Applikationen, beispielsweise Microsoft-Excel 
(siehe Bild 7), reagieren in dieser Situation dadurch, daß 
das vorhandene Menü stark verkleinert wird, was die Kom- 
plexität der Menüverwaltung weiter erhöht. 

Eines der schwierigsten Probleme beim MDI-Standard 
taucht auf, wenn die Größe des Applikationsfensters verän- 
dert wird. Obwohl es nicht möglich ist, ein Tochterfenster 
komplett aus dem Zeichenbereich des Hauptfensters zu 
schieben, ist dies schließlich doch möglich, indem die Größe 
des MDI-Hauptfensters verändert wird. Das Resultat ist ein 
Fenster (das vielleicht sogar das aktive ist), welches voll- 
ständig unsichtbar ist. Zwar kann das Fenster nicht mehr 
mit der Maus angesprochen werden, aber man kann es über 
die Abkürzungstasten erreichen, aber sichtbar ist es 
dadurch nicht geworden. 

Ein interessantes visuelles Phänomen kann erzeugt wer- 
den, indem man ([Strg)[-) eingibt, während das aktive 
Tochterfenster außerhalb des Inhalts des Hauptfensters 
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steht. Wie erwartet wird das Steuermenü des Tochterfen- 
sters aufgeschlagen, aber das Tochterfenster selbst bleibt 
unsichtbar. Als Resultat ergibt sich, daß das Steuermenü 
ohne Bezug auf dem Bildschirm erscheint und sich wie 
durch Magie selbst sichtbar gemacht hat (Bild 8). Mag sein, 
daß so etwas interessant aussieht, aber es ist sicherlich auch 
verwirrend für Benutzer! 


Das API des MDI 


Bis jetzt mögen Sie sich fragen, was an MDI eigentlich auf- 
regend ist - insbesondere wenn man bedenkt, daß es im 
Grunde nichts anderes ist als die Verwaltung einer Menge 
von zusammenhängenden Tochterfenster. Aber es gibt 
einen guten Grund, MDI einzusetzen - nämlich die Defini- 
tion und Implementierung einer Applikationsprogramm- 
Schnittstelle (im Original Application Program Interface, im 
folgenden als API bezeichnet), die MDI organisiert. Das 
Endergebnis des API ist eine kleine Bibliothek aus Objekt- 
modulen (ungefähr 16 Kbyte Gesamtgröße), die die 
gesamte Arbeit übernimmt, MDI in Ihre Applikation zu 
integrieren. Und als Bestes von allem: Sie ist im Preis der 
Ausgabe dieses Microsoft System Joumals eingeschlossen 
und kann auch auf Diskette bezogen werden! 

Um die Integrationsarbeit des API in eine Applikation 
zu schaffen, griff ich auf die Hilfe eines Freundes, langjähri- 
gen Kollegen und Windows-Gurus zurück - Geoffrey 
Nicholls. Zusammen entwickelten wir ein API, das es er- 
laubt, komplexe MDI-Applikationen zu schreiben, als 
wären sie einzelne unabhängige Applikationen. 

Wir erkannten von Beginn der Entwicklung an, daß ein 
solches API ziemlich unsauber würde und wir Dinge tun 
mußten, die wir niemals bei der konventionellen Windows- 
Programmierung tun würden. Weiterhin mußten wir ver- 
suchen, das API klein und einfach zu halten. Uns wurde 
auch klar, daß wir nicht die gesamte Spezifikation würden 
implementieren können, sondern nur einige der wichtigeren 
Features - den Rest wollen wir Ihnen überlassen. Schließ- 
lich wollten wir alles so objektorientiert wie möglich 
machen. Nach mehreren Fehlstarts und Neuprogrammie- 
rungen haben wir unser Ziel erreicht, vielleicht mit etwas 
übertriebener Verwendung von Besitzlisten und zusätzli- 
chen Fensterdatenbereichen. 

Das MDI-API wurde so entwickelt, daß es ein Analogon 
zum existierenden Windows-API darstellt. Aus früherer 
Erfahrung wußten wir, daß in großem Maße die Charakte- 
ristik eines Fensters durch die Funktion festgelegt ist, die 
die Ersatzverarbeitung der Fensternachrichten übernimmt. 
Das MDI-API versucht, diesen Unterbau zu ändern und 
jedem Fenster einen neuen und unterschiedlichen Satz von 
Charakteren zu geben. Das Endresultat ist eine kleine 
Anzahl Routinen mit vertrauten Paramceterlisten, welche 
zusammen verwendet werden, um Ihrer Applikation die 
MDI-Charakteristik zu verleihen. Die Routinen sind in 
Tabelle 2 aufgeführt. 
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MdiMainCreateWindow( ) 
Lege MDI-Hauptfenster an 


MdiMainDefWindowProc( ) 
Ersatz-Fensterfunktion des MDI-Hauptfensters 


MdiChildCreateWindow( ) 

Lege ein MDI-Tochterfenster an 
MdiChildDefWindowProc( ) 

Ersatz-Fensterfunktion eines MDI-Tochterfensters 


MdiGetMessage( ) 
Lese nächste MDI-Applikations-Nachricht 


MdiTranslateAccelerators( ) 
Übersetze Abkürzungstasten einer MDI- 
Applikation 

MdiSetAccel() 
Setze Abkürzungstasten-Tabelle für ein MDI- 
Dokument 


MdiGetMenu( ) 
Lese Menübezug eines MDI-Tochterfensters 


Tabelle 2: MDI-Applikations-Programmierschnittstelle 


Nachrichtenfluß und Prozeßablauf 


In den nächsten zwei Abschnitten wollen wir die internen 
Abläufe im MDI-API untersuchen. Zuerst beschreiben wir 
den allgemeinen Nachrichtenfluß und den Prozeßablauf im 
API. Dann erläutern wir jede der Eintrittsfunktionen und 
erklären einige der ausgetüftelten Verfahren, auf denen sie 
beruhen. Wenn Sie diese Abschnitte lesen, sollten Sie auf 
die MDI-Quelldateien zurückgreifen, die in diesem Artikel 
aufgeführt sind. Der Code ist ziemlich gut dokumentiert 
und Sie müßten ihn verstehen können, sofern Sie über ein 
gutes Hintergrundwissen bei der Windows-Programmierung 
verfügen. 

Nun, vielleicht der effizienteste Weg das MDI-API zu 
lernen, besteht darin, sorgfältig das MDI-Nachrichtenfluß- 
diagramm im Bild 9 zu studieren. Es verfolgt die Pfade 
jeder Nachricht, die von einer Applikation empfangen wer- 
den, die das API benutzt, wobei nur die uns interessieren- 
den Ausschnitte betrachtet werden. 

Die erste Eigenschaft, die zu beachten ist, betrifft die 
ziemlich normal aussehende Nachrichtenschleife mit der 
Entnahme, Übersetzung und Verteilung einer Nachricht am 
oberen Anfang des Diagramms. Dies erfolgt ähnlich wie in 
beliebigen anderen Windows-Applikationen, der einzige 
Unterschied besteht in der spezifischen Überprüfung menü- 
bezogener Nachrichten (dies erfolgt in der Funktion Mdi- 
GetMessage). Wenn eine solche Nachricht auftaucht, wird 
sie sofort an die entsprechende Fensterfunktion verteilt, um 
die verschiedenen Steuer- und Applikationsmenüs richtig 
aufzurufen. 
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Nach der Nachrichtenschleife wird jede Nachricht an die 
entsprechende Fensterfunktion gesandt. Soweit MDI 
betroffen ist, sind nur zwei Arten von Fenstern präsent: Ein 
Applikations- oder Hauptfenster und die Tochter- oder 
Dokumentfenster. Auf der linken Seite des Diagramms wird 
der Nachrichtenfluß für das Applikations-Hauptfenster 
gezeigt; auf der rechten Seite ist ein ähnlicher Ablauf für 
jedes der Dokumentfenster aufgeführt. 

Verfolgt man die linke Seite (die des Hauptfensters) 
wird jede Nachricht in der Fensterfunktion des Hauptfen- 
sters verarbeitet und anschließend der MDI-Ersatzfenster- 
funktion übergeben. Der Rest der Liste beschreibt die 
Ereignisse in dieser Ersatzfunktion, die in den meisten Fäl- 
len dadurch beendet wird, daß die Nachricht zur Standard- 
ersatzfunktion DefWindowProc gesandt wird. 

Wie Sie in dem Diagramm sehen können, ist die MDI- 
Ersatzfunktion hauptsächlich interessiert an Nachrichten 
zum Aktivieren und Initialisieren sowie befehlsspezifischen 
Nachrichten. Alle anderen Nachrichten werden unverändert 
an DefWindowProc übergeben. Von den ersteren werden 
einige abgefangen (etwa die Aktivierung eines bestimmten 
Tochterfensters); andere werden verarbeitet und direkt an 
das entsprechende Tochterfenster gesandt - unter Umge- 
hung der Ersatzfensterfunktion. 

Auf der rechten Seite (die der Dokumentfenster) des 
Diagramms befindet sich die Sequenz von Ereignissen, die 
beim Empfang von Nachrichten durch die MDI-Tochter- 
fenster-Funktion auftreten. Wie auf der linken Seite ist der 
Ablauf in der Ersatzfunktion aufgeführt, der in den Fällen 
damit endet, daß die Nachricht an die Standard-Ersatz- 
funktion DefWindowProc weitergeleitet wird. 

Wie die Hauptfenster-Ersatzfunktion ist auch die 
Ersatzfunktion der Dokumentfenster vorwiegend interes- 
siert an Nachrichten zum Aktivieren und Initialisieren sowie 
befehlsspezifischen Nachrichten. Wichtig sind insbesondere 
die verschiedenen Systembefehle. Einige werden direkt 
behandelt und nicht zum System geschickt. In anderen Fäl- 
len, beispielsweise wenn ein Menü oder ein neues Doku- 
mentfenster aktiviert wird, wird die Nachricht direkt an das 
Hauptfenster geschickt. 

An bestimmten Stellen im Diagramm kann man Felder 
mit dickerem Rahmen sehen, welche die Aktivierung eines 
Dokument-Fensters beschreiben. Bild 10 zeigt den gleichen 
Ablauf, in kleinere Schritte aufgeteilt. 

Bei einer normalen Windows-Applikation erfolgt die 
Aktivierung eines Fensters ohne größeres Geschrei, aber 
bei einer MDI-Implementierung müssen eine Reihe von 
wichtigen Schritten durchgeführt werden. Zunächst muß die 
Farbe in der Titelleiste geändert werden. Obwohl Windows 
dies nur für das eine Fenster erlaubt, welches den Einga- 
befokus besitzt, entsteht der Eindruck, daß beim Aktivieren 
eines Tochterfensters sowohl das Hauptfenster als auch das 
Tochterfenster gleichzeitig aktiv sind. Dies erfolgt, indem 
manuell eine WM_NCPAINT-Nachricht an DefWindowProc 
des zu aktivierenden Fensters geschickt wird. 


Microsoft System Journal 1 1 


Bild 9: MDI-Nachrichten-Flußdiagramm 
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Aktiviere Tochterfenster 


Wechsele Titelleisten-Farbe 


Setze Objekte in Titelleiste 
(Steuermenü, Vollbildfeld) 


Zeichne Fensterrahmen 


Deaktiviere bisher 
aktives Tochterfenster 


Setze gültige Menüleiste 


Markiere Eintrag in 
»Fenster«-Menü 


|_Wechsele Titelleisten-Farbe | 
Er 


Setze Eingabefokus 


Bild 10: Ablauf beim Aktivieren eines MDI-Tochterfensters. 


Weiterhin enthält laut Schnittstellendefinition nur das 
gegenwärtig aktive Dokumentfenster ein MDI-Steuermenü 
und Felder für Voll- und Sinnbild. Deshalb wird im zweiten 
Schritt der Fensterstil entsprechend geändert und an- 
schließend das System aufgefordert, die Änderungen anzu- 
zeigen. 

Der nächste bedeutende Schritt beim Aktivieren eines 
Dokumentfensters besteht aus dem Setzen der Menüleiste 
im Hauptfenster. Jedes Tochterfenster besitzt seine eigene 
Menüleiste. Wenn es aktiviert wird, wird die augenblickliche 
Menüleiste entfernt und die neue eingefügt mit allen Attri- 
buten, die sie besitzt. Schließlich werden die Einträge im 
»Fenster«-Menü aktualisiert, um den aktuellen Status im 
Hauptfenster anzuzeigen. Erst dann enthält das Dokument 
abschließend den Eingabefokus. 

Wie Bild 10 enthalten die Bilder 11 und 12 den Ablauf 
von Ereignissen, die sich ergeben, wenn ein Dokumentfen- 
ster als Vollbild dargestellt wird oder ein anderes Fenster 
ausgewählt wird, während das aktuelle ein Vollbild ist. Bei 
beiden Abläufen besteht die einzige technisch interessante 
Aktion aus dem automatischen Einfügen des MDI-Steuer- 
menüs am Beginn der Applikations-Menüleiste. 
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Setze Tochterfenster 
als Vollbild 


Füge Steuermenü des 
Tochterfensters in 
Menüleiste ein 


Setze Titel des 
Tochterfensters in 
Titelleiste des Hauptfensters 


Sichere Position 
und Größe des Fensters 


Setze Vollbild-Größe und Position 


v 


Setze Fensterstil-Flags 


Bild 11: Ablauf beim Abbilden eines MDI-Tochterfensters als 
Vollbild. 


Hierzu muß zunächst auf das MDI-Steuermenü im 
Windows-System zugegriffen werden, was so geschieht: 


hBitmap=LoadBitmap(NULL ‚MAKEINTRESOURCE(OBM_CLOSE)); 


Das erhaltene Rasterbild enthält sowohl das Standard- 
Steuermenüfeld als auch das spezielle eines Tochterfen- 
sters. Nachdem die Dimensionen des Rasterbilds mit der 
Funktion GetObject ermittelt wurden, wird das Steuer- 
menüfeld des Tochterfensters entnommen, um es in die 
Menüleiste der Applikation einzufügen. Der ganze Ablauf 
steht in der Funktion MdiCreateChildSysBitmap und 
war bisher nicht allgemein publiziert worden. Sie sollten die 
Neigung verspüren, sich anzuzusehen, was genau in dieser 
Funktion passiert! 


Eintrittsfunktionen des API 


Nachdem wir den Nachrichtenfluß und den Prozeßablauf 
von MDI diskutiert haben, wollen wir uns nun die Ein- 
trittsfunktion ansehen, die das API zur Verfügung stellt. 
Programmiertechnisch gesprochen können Sie das MDI- 
Interface bei Ihren eigenen Applikationen ohne größere 
Probleme anwenden, wenn Sie die Bedeutung dieser Funk- 
tionen verstanden haben. 
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Tochterfensterwechsel 
bei Vollbilddarstellung 


L; 


Ändere Titelleiste 


Sichere Position und Größe 
des darzustellenden Fensters 


Setze Vollbild-Größe und Position 
des darzustellenden Fensters 
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Setze Fensterstil-Flags 


v 
Füge Steuermenü 
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Dokument-Menüleiste ein 
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Zeige Fenster 
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Lösche Fensterstil-Flags des 
bisherigen Fensters 


rv 


Setze Position und Größe 
des bisherigen Fensters 
zurück 


Entferne Steuermenü 
in bisheriger 
Dokument -Menüleiste 


v 


Aktiviere Tochterfenster 


Bild 12: Ablauf beim Wechseln zwischen MDI-Tochter- 
fenstern in Vollbilddarstellung. 


Die erste Funktion ist MdiMainCreateWindow, die 
verantwortlich ist für das Erzeugen des Hauptfensters und 
alle zugeordneten MDI-Besitzlisten, welche für das Inter- 
face benötigt werden. Die eigentlichen Datenstrukturen, die 
vom API verwendet werden, werden in Besitzlisten (proper- 
ty lists) des Hauptfensters und der Dokumentfenster gehal- 
ten. Eine Besitzliste ist ein Versuch, jedem Fenster den 


14 Microsoft System Journal 


Zugriff auf eine Reihe von Vorkommen-Daten zu geben 
(dieser Begriff wurde aus der objektorientierten Program- 
mierung übernommen). Dies wird dadurch erreicht, daß 
dem Fensterbezug ein benannter Speicherblock zugeordnet 
wird. Das Windows-System erlaubt jedem Fenster, Besitz- 
listen anzulegen, zu bestimmen, zu lesen oder wieder zu 
zerstören. Obwohl es keine vordefinierte obere Grenze gibt, 
wieviel benannte Speicherblöcke ein Fenster besitzen kann, 
wird die maximale Größe der Besitzlisten dadurch be- 
schränkt, daß sie wie die anderen Fensterdaten sich im 
lokalen Heap der »User«-Bibliothek von Windows befin- 
den. Die Funktion MiiMainCreateWindow weist auch das 
»Fenster«-Menü dem Hauptfenster zu, dadurch ist das 
MDI-Interface ständig transparent für die Applikation. 

Die zweite API-Eintrittsfunktion ist MdiMainDefWin- 
dowProc. Wie bereits im MDI-Nachrichtenflußdiagramm 
beschrieben, ist die Funktion verantwortlich für die Ersatz- 
verarbeitung aller hauptfensterspezifischen Nachrichten. 
Genauer: $ie ist interessiert an Nachrichten, die die Akti- 
vierung und Deaktivierung des Hauptfensters betreffen, sich 
auf die Menüs beziehen und an Nachrichten für die Sicht- 
barmachung und Größeneinstellung der zugeordneten 
Dokumentfenster. Sie wurde mit einer großen switch- 
Anweisung implementiert und gibt die meisten Nachrichten 
an die Funktion DefWindowProc weiter. 

Der nächste API-Einsprung ist die Funktion Mdi- 
ChildCreateWindow. Sie ist in vielfacher Hinsicht iden- 
tisch mit der Standard-Windows-Funktion CreateWindow 
und legt ein neues Tochterfenster innerhalb des Applikati- 
onsfensters an. Im Hintergrund legt sie die Besitzlisten an, 
behält das »Fenster«-Menü und die Abkürzungstasten- 
Tabelle im Auge und aktiviert das Fenster so, wie es der 
augenblickliche Zustand der Applikation verlangt. 

Wie beim Hauptfenster erhält jedes Dokumentfenster 
eine MDI-Funktion als Ersatzfunktion zum Verarbeiten der 
Nachrichten. Sie besitzt den Namen MdiChildDefWin- 
dowProc und ist verantwortlich für die Ersatzverarbeitung 
aller tochterfensterspezifischen Nachrichten, insbesondere 
jene zur Auswahl des Steuermenüs und zur Anlage, Aktivie- 
rung und Zerstörung des Fensters. Andere Nachrichten 
werden entweder direkt zum Hauptfenster gesandt oder der 
Funktion DefWindowProc übergeben. 

Nach der Tochterfenster-Ersatzfunktion gibt es mit der 
Funktion MdiGetMessage einen Ersatz für die entspre- 
chende Windows-Standardfunktion. Jene ist verantwortlich 
für die Entgegennahme aller Applikationsnachrichten aus 
dem Nachrichteneingangspuffer. Sie überprüft auch den 
Tastaturzugriff auf das Menü und aktiviert das korrekte 
Menü, wenn die Richtungstasten verwendet werden, um ein 
anderes Menü auszuwählen. 

Als nächstes folgt die Funktion MdiTranslateAcce- 
lerators, welche jede Nachricht gemäß der aktuell 
gesetzten Abkürzungstastentabelle übersetzt. Obwohl die 
meisten Applikationen nur eine solche Tabelle besitzen, 
können MDI-Applikationen mehrere von ihnen besitzen - 
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Bild 13a: Das Programm COLORS kann rote, grüne und 
blaue Tochterfenster mit unterschiedlichem Grauwertanteil 
anlegen. Jedes neue Tochterfenster wird automatisch in einer 
kaskadenähnlichen Reihe positioniert. 


eine für das Hauptfenster und je eine für einen Dokument- 
fenster-Typ. Die Funktion überprüft automatisch den Status 
der Applikation und verwendet die passende Abkürzungs- 
tasten-Tabelle. 

Schließlich wurden zwei Hilfsfunktionen in das MDI- 
API aufgenommen, die als Makro implementiert wurden 
und MdiGetMenu beziehungsweise MdiSetAccel heißen. 
Die beiden Funktionen sind erforderlich, weil die meisten 
Applikationen eine Abkürzungstasten-Tabelle anlegen und 
auf die aktuelle Menüleiste zugreifen. Dies erfolgt durch 
das MdiGetMenu-Makro, welches den Menübezug der ent- 
sprechenden Dokument-Menüleiste ermittelt. Das Makro 
MdiSetAccel dagegen setzt eine Abkürzungstasten-Tabel- 
le in der Besitzliste des angegebenen Dokumenifensters. 
Die Tabelle kann dann automatisch benutzt werden, wenn 
Nachrichten übersetzt und verteilt werden, ohne daß die 
Applikation eingreifen muß. 

Zusammengefaßt repräsentieren diese acht Funktionen 
das gesamte MDI-API. Obwohl die Funktionen nicht ein- 
fach ungestraft verwendet werden können, sollten sie sich 
doch gut in die meisten denkbaren Applikationen integric- 
ren lassen. Wenn sie vorsichtig angewandt werden, verber- 
gen sie die meisten feinen Einzelheiten von MDI und 
ermöglichen Ihnen, sich auf die programmspezifischen Pro- 
bleme zu konzentrieren und nicht ein neues Verfahren für 
die Verwaltung von Tochterfenstern erfinden zu müssen. 
Die einzige ziemlich unschöne Angelegenheit ist die Instal- 
lation eines Systemeingriffs (hook) für die System-Nach- 
richten. Dieser Eingriff fängt die Richtungstasten innerhalb 
der Menüverwaltung ab. Ohne den Eingriff wäre es sehr 
schwierig, ein wirklich authentisches MDI-Tastaturinterface 
zu implementieren. 
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Bild 13b: COLORS besitzt das Standard-»Fenster«-Menü, 
welches eine Liste aller angezeigten Fenster besitzt. Mit weite- 
ren Befehlen können die Fenster verborgen und wieder ange- 
zeigt werden. 


Erzeugen von MDI.LIB 


Um die MDI-API-Bibliothek anzulegen, müssen zunächst 
die Dateien MDI1.C, MDI2.C und MDI3.C (siehe Listings 
2,3 und £) vorhanden sein. Weiterhin wird die Datei MDI.H 
benötigt (Listing T), die auch die Schnittstelle zum MDI- 
Anwenderprogramm darstellt. Zusätzlich zu diesen Quell- 
dateien werden das Microsoft-Windows-SDK, Version 2.1 
und der Microsoft-C-Compiler, Version 5.1 benötigt. 

Die MAKE-Datei zum Erzeugen der Bibliothek (Listing 
5) übersetzt jedes der Module im »medium«-Speicher- 
modell und kombiniert sie in eine Objekt-Bibliothek mit 
Hilfe des LIB-Programms, welches dem C-Compiler bei- 
liegt. Diese Bibliothek kann dann ohne Änderung für jede 
MDI-Applikation verwendet werden, die mit dem 
»medium«-Speichermodell übersetzt wird. Falls gewünscht, 
kann man die Übersetzungsflag in der MAKE-Datei 
ändern und sich dadurch eine entsprechende Bibliothek für 
das »small«-, »compact«- und »large«-Modell schaffen. 


Verwendung des MDI-API 


Ich werde im folgenden das Programm COLORS.EXE ver- 
wenden, um zu zeigen, wie das MDI-API als Erweiterung 
einer einfachen Applikation verwendet wird. Anhand dieses 
Programms wird gezeigt, wie einfach und konsistent die 
Verwendung des MDI-API ist. COLORS kann leicht als 
eine Sammlung von drei verschiedenen, noch zusammen- 
hängenden Programmen gesehen werden. Allein verhalten 
sie sich wie drei separate Applikationen, obwohl sie die 
gleiche Fensterfunktion verwenden. Durch das MDI-API 
werden sie in einem Hauptfenster zusammengelegt. 
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Bild 13c: Die blauen Tochterfenster besitzen Abkürzungs- 
tasten, die im »Blau«-Menü aufgeführt sind (2, 5, 7 oder 1). 
Mit ihnen kann sehr schnell der Grauwertanteil der blauen 
Farbe eines Fensters geändert werden. Die Tochterfenster 
können natürlich in Position und Größe geändert werden. 


Mit der COLORS-Applikation kann man mit Hilfe des 
»Neu«-Befehls im Menü »Datei« eine Anzahl von roten, 
grünen und blauen Dokumentfenstern erzeugen. Jedes der 
Fenster erhält eine sukzessive Nummer und kann über ein 
gleichnamiges Menü in unterschiedlichen Helligkeiten 
abgebildet werden. Von den drei Dokumentfenster-Typen 
hat der Blaue die Besonderheit, daß er Abkürzungstasten 
besitzt. Durch Drücken der Tasten 0, 1, 2, 5 oder 7 kann die 
Intensität des blauen Fensterhintergrunds auf 0%, 100%, 
25%, 50% oder 75% geändert werden. Bild 13 zeigt 
verschiedene Beispiele, wie COLORS aussehen kann. 

Wenn mehrere Dokumente im Applikations-Hauptfen- 
ster sichtbar sind, kann ein Wechsel von einem Fenster zum 
anderen über drei verschiedene Mechanismen erfolgen: 
Selektieren eines Fensters mit der Maus, Verwendung der 
Tastatur (mit den festgelegten Tasten und 
(Vasch)[Strg)(F8)) oder Aufruf des Menüs »Fenster« und 
Auswahl des Namens mit dem gewünschten Dokument. 
Darüber hinaus kann mit dem »Fenster«-Menü das gerade 
aktive Dokument verborgen bzw. ein verborgenes wieder 
angezeigt werden, wie man es von anderen MDI-Applika- 
tionen gewohnt ist. 

Der Quelltext des Programms besteht aus folgenden 
fünf Dateien, die in den Listings 6 bis 10 abgedruckt sind: 


COLORS 
COLORS.DEF 
COLORS.RC 
COLORS.H 
COLORS.C 


Der erste Zugriff auf das MDI-API erfolgt in der 
MAKE-Datei zum Erzeugen der Applikation (Listing 6). 
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Bild 13d: Wenn ein Tochterfenster außerhalb des Applikati- 
onsfensters von COLORS ist, kann weiterhin über die Tasta- 
tur darauf zugegriffen werden. Hierbei wird ein »einsames« 
Steuermenü angezeigt, genau wie bei Microsoft-Excel (siehe 
Bild 8). 


Die Übersetzung von COLORS.C ist abhängig von den 
Dateien MDI.H und MDI.LIB. Weiterhin wird auf die 
MDI-Bibliothek in der Befehlszeile des Linkers zugegriffen, 
wodurch COLORS auf alle globalen Routinen des MDI- 
API zugreifen kann, die wir vorher definiert haben. 

Die nächste Datei, die Zugriffe auf den MDI-API ent- 
hält, ist die Linker-Definitionsdatei COLORS.DEF (Listing 
7), in der die Funktionen MdiMsgHook und MdiDlgUn- 
hide als exportiert angegeben worden sind, da sie ver- 
schiebbare Eintrittspunkte sind, die vom Windows-System 
verwendet werden. Wird der Eintrag in COLORS.DEF ver- 
gessen, treten merkwürdige Fehler auf. 

Die dritte Referenz auf das MDI erfolgt in der Ressour- 
cen-Datei COLORS.RC (Listing 8). Es ist zu beachten, daß 
die Kopfdatei MDI.H eingebunden wird und gegen Ende 
der Ressourcen-Datei eine Anzahl MDI-bezogener Res- 
sourcen (Dialogfelder etc.) definiert werden. Die erste die- 
ser Ressourcen stellt das MDI-Menü »Fenster« dar, welche 
als Schablone definiert ist und vom MDI-API an die einzel- 
nen Dokument-Menüleisten angehängt wird sowie automa- 
tisch am Menüende um die Namen der angezeigten Doku- 
mente ergänzt wird. 

Die nächste Ressource stellt die Tabelle der Abkür- 
zungstasten für die MDI-Tochterfenster dar. Die Tabelle 
wird automatisch vom API geladen und verwendet, um die 
Tastaturschnittstelle zum Dokument-Tochterfenster zu 
implementieren. Die letzte Ressource schließlich definiert 
das MDI-Dialogfeld für den Befehl »Anzeigen« und wird 
aufgerufen, nachdem der entsprechende Befehl im »Fen- 
ster«-Menü ausgewählt wurde. Als MDI-Entwickler kann 
man den Stil und Aufbau des Dialogfelds für eigene Zwecke 
anpassen, man sollte jedoch aufpassen, daß man nicht die 
Namen und Stilbezeichnungen versehentlich ändert. 
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Nach der Ressourcen-Datei und der Definitionsdatei 
COLORS.H (Listing 9) folgt mit Listing 10 schließlich 
COLORS.C, welche den gesamten C-Quellcode der 
COLORS-Applikation enthält und von der Struktur her 
anderen Windows-Programmen ähnelt. Wie COLORS.RC 
greift auch COLORS.C auf die Datei MDI.H zu, die außer 
den benötigten Bezeichnern auch die Prototypen sämtlicher 
MDI-API-Einsprungfunktionen enthält. 

Die erste MDI-bezogene Aktion in COLORS.C ist das 
Anlegen des MDI-Hauptfensters der Applikation durch 
Aufruf der Funktion MdiMainCreateWindow innerhalb 
von MainInit. Dieser Aufruf legt ein leeres Fenster mit 
dem standardmäßigen Hauptmenü an. Doch bereits kurz 
nach dem MdiMainCreateWindow-Aufruf erfolgt die 
Ausführung der COLORS-Funktion ColorCreate, welche 
ein neues Dokument-Fenster anlegt, wobei sie die Funktion 
MdiChildCreateWindow verwendet, und weist diesem 
Fenster die dazugehörende Abkürzungstasten-Tabelle zu. 
Beim Aufruf von COLORS wird dadurch standardmäßig ein 
rotes Dokumentfenster angelegt. 

Nachdem die Oberfläche angelegt und initialisiert wor- 
den ist, empfängt die Applikation alle sie betreffenden 
Nachrichten und verarbeitet sie. Wie bei den meisten Win- 
dows-Applikationen erfolgt dies mit einer einfachen 
Schleife, beginnend mit einem GetMessage-Aufruf, dem 
die Vorübersetzung und anschließende Verteilung für jede 
eingegangene Nachricht folgt. Hier haben die MDI-Funk- 
tionen MdiGetMessage und MdiTranslateAccelera- 
tors jedoch die Windows-API-Funktionen ersetzt. 

Der nächste Zugriff auf den MDI-API erfolgt in der 
Funktion MainWndProc von COLORS. Jede Nachricht, die 
in der Nachrichten-Schleife der Applikation empfangen 
wurde, wird direkt an die bestimmte Fensterfunktion 
gesandt. MainWndProc empfängt alle Nachrichten, die für 
das MDI-Hauptfenster bestimmt sind und, da dieses Fen- 
ster das einzige mit einem Menü ist, auch alle Nachrichten, 
die Menüs betreffen. 

Die Fensterfunktion des Hauptfensters verarbeitet nur 
Nachrichten, die die Applikation betreffen. Alle weiteren 
Nachrichten werden zur Weiterverarbeitung der Funktion 
MdiMainDefWindowProc übergeben. Diese Funktion (im 
MDI-Code) verarbeitet ihrerseits alle Nachrichten, welche 
für MDI von Interesse sind und sendet einige dieser Nach- 
richten weiter an entsprechende Dokument-Tochterfenster. 
Die anderen Nachrichten werden dem Windows-System mit 
der Funktion DefWindowProc übergeben. 

Während des ganzen Prozesses kann das Hauptfenster 
Nachrichten empfangen, die Befehle angeben, welche in 
einer der Dokument-Menüleisten aufgerufen wurden. Da- 
her ist es sinnvoll, daß die Dokumentfenster einen gemein- 
samen Satz von Menüeinträgen besitzen, die in der Haupt- 
fensterfunktion zentral verarbeitet werden. Bei COLORS 
sind diese Befehle im »Datei«-Menü zusammengefaßt. 

Es ist zu beachten, daß lediglich die Menüeinträge von 
Hauptfenster und Dokumenten konzeptionell getrennt wer- 
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den müssen, nicht dagegen die Einträge der einzelnen 
Dokumenten-Menüs. Diese können sich nicht gegenseitig 
beeinflussen, da nur das aktive Dokument die Befehle sei- 
ner aktiven Menüleiste erhält und nicht die von inaktiven 
Dokumenten. 

Die letzten Aufrufe des MDI-API erfolgen in der Fen- 
sterfunktion ColorWndProc. Diese Funktion wird von 
allen Dokument-Tochterfenstern gemeinsam benutzt und 
verarbeitet die dokumentspezifischen Menübefehle und 
zeichnet den Fensterhintergrund in der entsprechenden 
Farbe mit der eingestellten Intensität. In ColorWndProc 
wird auf die gesetzte Menüleiste mit MdiGetMenu statt mit 
GetMenu zugegriffen. Dies ist wichtig, da das Hauptfenster 
die Menüleiste enthält und dieses nicht immer das unmit- 
telbare Mutterfenster (parent window) des Dokuments sein 
muß (sonst könnte man auf die Menüleiste mit Get- 
Menu(GetParent(hWnd)) zugreifen). 

Ähnlich wie die Fensterfunktion des Hauptfensters 
übergibt ColorWndProc die meisten Nachrichten der 
Ersatz-MDI-Nachrichtenverarbeitung, in diesem Fall der 
Funktion MdiChildDefWindowProc. Diese Funktion ver- 
arbeitet einige Nachrichten, die MDI betreffen und leitet 
die anderen über DefWindowProc weiter zum System. In 
bestimmten Situationen werden Nachrichten auch an das 
Hauptfenster umgeleitet und nicht dem System übergeben. 

Wenn Sie COLORS erzeugen, experimentieren Sie damit 
und beobachten Sie dabei, wie die internen Funktionen in 
verschiedenen Situationen reagieren. Verstecken Sie alle 
Dokumente oder legen Sie neue an, während sich eines in 
der Vollbildstellung befindet. Prüfen Sie die Tastatur- 
schnittstelle, indem sie sich von Dokument zu Dokument 
bewegen, ohne die Maus zu Hilfe zu nehmen. 

Nach einer Weile wird Ihnen allmählich bewußt werden, 
welcher Aufwand im Hintergrund getrieben werden mußte, 
um die Schnittstelle konsistent zu halten. Doch gerade 
wegen der sichtbaren Intelligenz wird ein wachsender 
Overhead vom API aufgebaut. Wenn man schnell zwischen 
unterschiedlichen Dokument-Fenstern: hin und her wech- 
selt, ist dieser Overhead sichtbar. Obwohl dies teilweise auf 
den recht einfältigen Ansatz bei COLORS in der Nach- 
richtenverwaltung zurückzuführen ist (alle Nachrichten 
werden an die Ersatzfensterfunktion weitergegeben) muß 
dies zu einem Großteil dem MDI-API selbst zugeordnet 
werden. 

Nichtsdestoweniger sollte man sich in Erinnerung rufen, 
daß die Ziele des hier vorgestellten MDI-API bei der Ent- 
wicklung in erster Linie Klarheit und Lesbarkeit waren. 
Unsere interne Arbeitsversion des API (auf dem die hier 
vorgestellte Bibliothek beruht) implementiert dagegen die 
volle MDI-Spezifikation erheblich effizienter als es diese 
hier tut, sie realisiert die »Fenster«-Menübefehle »Neu«, 
»Nebeneinander« und »Immer Nebeneinander« und sie 
kann Dokumentfenster als Sinnbilder darstellen. Die zen- 
tralen Strukturen jedoch bleiben die gleichen - mit ein 
bißchen Leistungssteigerung und Verbesserungen ist die 
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Basis des vorgestellten API geeignet, Weltklasse-MDI- 
Applikationen mit unvergleichbarer Leichtigkeit zu unter- 
stützen. Verbunden mit ein wenig Umdenken bei der 
augenblicklichen Technik bei der Datenverarbeitung wer- 
den Sie bei vielen der existierenden Windows-Applikationen 
die MDI-Benutzerschnittstelle leicht hinzufügen können. 
Und, vielleicht das Beste daran: Mit dem MDI-API schaf- 
fen Sie dies mit wenig Änderungen in Ihrem Quellcode. 


MDI und SAA 


Zusätzlich zu dem Vorteil der Übertragbarkeit der Benut- 
zeroberfläche durch MDI ist eine der wichtigsten Stützen 
für Entwickler die Akzeptanz durch die SAA-Spezifikation 
von IBM. Obwohl ein umfassender Überblick über SAA 
den Rahmen dieses Artikels sprengen würde wollen wir 
doch kurz darauf eingehen, wie die SAA-Spezifikation MDI 
beinflußt. 

SAA ist eine Menge ausgewählter Software-Schnittstel- 
len, Konventionen und Protokolle, die als Rahmen für den 
Entwurf von Applikationen dienen, welche portabel sind 
und auf drei wichtigen Computer-Standbeinen steht: IBM- 
System//370, System/3X und Personal Computer. 

Ein wichtiger Teil von SAA ist die CUA-Spezifikation. 
Dieser Standard legt mit einer langen Liste von Regeln und 
Richtlinien fest, wie ein SAA-gefälliges Benutzerinterface 
aussehen sollte und wie es verwendet wird. Als Endergebnis 
entstand ein mehr als 300 Seiten umfassendes Dokument, 
das bei Ihrem lokalen IBM-Repräsentanten erhältlich ist 
und in mühsamer Kleinarbeit die SAA-Mensch/Maschinen- 
Schnittstelle beschreibt. 

Warum sind SAA und CUA so bedeutend? Ungeachtet 
der Tatsache, wie Sie darüber denken, besteht der entschei- 
dende Faktor darin, daß viele große Unternehmen versu- 
chen, auf eine einheitliche Benutzerschnittstelle zu setzen, 
die eine Vielzahl von Hardware-Plattformen umfaßt. 

Dies wird ergänzt durch die Hoffnung, daß Benutzer 
leicht von Maschine zu Maschine wechseln können, ohne 
daß sich bei jedem Übergang erneut eine Einarbeitungs- 
Lernkurve ergibt. Die Unternehmen beginnen, von ihren 
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Verkäufern zunehmend SAA- und CUA-verträgliche Soft- 
ware zu fordern. Microsoft versucht gerade daraus Kapital 
zu schlagen, indem es ein SAA- und CUA-verträgliches 
Windows entwickelt (betrifft alle unbenützten Abkür- 
zungstasten). 

MDI als integraler Bestandteil der Windows-Strategie 
von Microsoft paßt in diesen umfassenden Standard. Das 
Endergebnis - und dies ist der Grund, warum MDI für Sie 
als Software-Entwickler so bedeutend ist - liegt darin, wenn 
Sie das MDI-Interface in Ihrer Applikation benutzen (im 
Gegensatz zu anderen Schemen), daß Ihre Benutzer bereits 
vertraut sind mit der Schnittstelle und Sie möglicherweise 
mehr Software verkaufen. Zumindestens sollten Sie einen 
ausführlicheren Blick auf die SAA- und CUA-Spezifikatio- 
nen von IBM werfen und sie sich durch den Kopf gehen las- 
sen. Ich persönlich habe lange Zeit mit den Einschränkun- 
gen gekämpft, die mir CUA als Entwickler auferlegt, aber 
ich werde mit ihnen leben können, da sie meine Programme 
auf eine breitere Basis stellen. 

Ich hoffe, daß diese Diskussion Ihnen Ideen und Ein- 
blicke gegeben hat, die Ihnen eine Hilfe bei Ihren eigenen 
Entwicklungen sind. MDI könnte die Antwort auf einige 
technische Probleme sein, mit denen Sie zur Zeit kämpfen. 
Wenn Sie sich mit MDI beschäftigen, sollten Sie bedenken, 
daß es aus der Notwendigkeit heraus entstanden ist, meh- 
rere Fenster innerhalb eines Hauptfensters zu organisieren. 
Diese Entstehung ist im günstigsten Falle lästig und steht 
darüber hinaus noch im Widerspruch zur darunterliegenden 
Hardware. Vielleicht wird in Zukunft etwas ähnliches wie 
das MDI-API einmal in den Windows- oder OS/2-PM-API 
eingebaut, was Ihnen und mir große Mühen ersparen 
dürfte. Bis dahin haben Sie mit diesem Artikel etwas mehr 
über MDI in der Hand als bisher. 

Kevin P. Welch 


Kevin P. Welch studierte Computerwissenschaften mit den 
Schwerpunkten angewandte Mathematik, Robotik und künst- 
liche Intelligenz. Er ist Präsident der Eikon Systems Inc. sowie 
Doktorand in angewandter Mathematik und schrieb zahlrei- 
che Artikel auf vielen verschiedenen technischen Gebieten. 
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= MDI.H - Kopfdatei der MDI-Bibliothek 
hd x (Schni ttstelle für MOI-Applikationen) 


. EISGERwLSESPEACNA nissosatert 5.1 
* Entwicklungsumgebung: Microsoft Windows 2.1 SDK 
= x Status: einsatzfähig 


id = Entwickelt von: 
”* Geoffrey Nicholls 
‘ Kevin P, Welch 


c right 52 

* Sl Yrtles, 1 
“989 E. issue Bivd Suite 260 
ae City CA 94408 


Ir 
“ Programmierer-Interface der Kopfdatei 


/* Fensterklassen-Optionen für MDI-Tochterfenster */ 
#define WS MDICHILD WS_CAPTIONIWS Ws ctlrs ELISCHILDREM 
IWS_VISIBLE |WS_THICKFI 'S_CLIPSTBLINGS 


/* Menü-Zugriffe fr, Vochtarfenster / 
#define Ka Reha) Frpfenpg _CHILDMENU) 
#define MdiSetAccel (w,a) Pr w,PROPTACCEL,a) 


5 ‚Evehtioaauuftefe “ll 
ND MdiMainCreateWindow 

"LpsTR, LPSTR,DWORD, int, int, int, int, HWND,KMENJ , HANDLE, LPSTR) ; 
NöikainDefWindonProc(HiND, unsigned, NORD, LONG) ; 


LPSTR DWORD Ha int int,int an: HMENU ,HANDLE,LPSTR) ; 
HdiChilddefWi WMipdseeronl Junsı LONG); 5 1; 
1OOL iiSaehessaget HWND, LPNSG, HNO, RD); 
int MdiTranslat: celerators(HWND, LPNSG 5% 


I EINER In Steuermenü eines Tochterfensters */ 
üeinträge sollten nicht anderwertig verwendet werden! */ 
Idefine ID oroE 0x3f00 


Ki gen im "Fenster*-Menü der Applikation */ 
define INDOW  0x3f07 
Kleine TONCARRANGE 


hderine TOM" FIRSTWIN 
#define WINDOW_POS 


I" 
SE PER INFEINE Teil der Kopfdatei 


I" FOnsiBeistes: A MDI- "Hangtfüestars arten) “f 

Adefine PROP_AC "MdiParentActiv. 
"MdiParentChildCount" 
"MdiParentHiddenCount* 
„MdiParentChi 1dZoomed" 


indowHenu" 
i D Sndipanentcht 1dSysAccel ‚ 
"MdiParentChi 1dSysHenu* 
#define PROP_TITLE "HdiParentTitle” 


/* Fensterdatei Lam: MDI-Tochterfenster */ 
PROP_LEFT "MdiChildRestoreleft“ 
"HdiChildRestoreTop" 
"MdiChildRestoreWidth* 
„HdichildRestoreleight“ 
"MdiChildMenu" 
"MdiChildAccel* 
PROP”| "Mdichildid* 
Hierin PROPTISMDI "HdiChildWeAreüne* 


/* Fensterstil des kiatenfelds in Dialogfeld "Anzeigen" */ 
#define DLGUNHIDE_LB x 100 


/* Rasterbild des Tochter fenster: Stevermenüs */ 
#define OBH_CLOSE 767 


4% Dackuebmarte von WM_MENUCHAR (stehen nicht in WINDOWS.H) */ 
#define MC_ABORT A 
#define MC_SELECT 2 


/* Statuswerte des Tastatur-Interface für Menüs */ 
#define POP_NONE -3 
Adefine POP_HAINSYS -2 


Idefine POP_CHILDSYS -] 
idefine POPMAINIST 0 


I" 
Pal aaa der Funktionen 
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/* w12.C */ 
HWND DM CrentsckE1 det in 
MdiDestroyChildwi 
Walketfvatschi 1a MM 
MdiActivatelextChild 
tePrevChild 


M deChild ; 
void MdiUnhideChi a )i 
Int FAR PASCAL KaiDIgUnhide( „ unsigned, WORD, LONG ); 
/* w013.C */ 
void 


Zoomilenu( 
en sm 
Ndi ndomToMen ,; 
MdiRei ad elalane % 
NdiRemoveli Frenlanı IBlin. 


oid Ndikenulles: 
LONG FAR PASCAL HöisgHook( Kin ieh, DR. ”) 
void WdifreeMenuKeytkook( void ); 


/* Externe Funktionen (von Windows zur Verfügung gestellt) */ 
LPSTR FAR PASCAL Istrepy( LPSTR, LPSTR ); 


Listing 1: (Ende) 


I" 
„ „ monl.c - Schnittstelle zur Applikation 
: ERSpESmIISEHrache: Rlsrospfat 5.1 


he} sin: Aieresoft Windows 2.1 SDK 
id „Status: einsatzfähig 


= X Slasse Nodul enthält den gesamten MDI-Code der HDI-: CerOpeemeter- 

* schnittstelle. Dies umfaßt unter anderem das Erzeugen der Austen, die 
* Ersatzverarbeitung der Nachrichten und den Code zum Aufruf in der 

* Nachrichtenschleife. Das MDI-Hauptfenster und die MDI-Tochterfenster 
" haben unterschiedliche Funktionen zum Verarbeiten der Nachrichten, 

2 während die Nachrichtenschleife fensterunabhängig ist. 


* Entwickelt von: 
* Geoffrey Nicholls 
*" Kevin P, Welch 


2 Eile rien, In 1988 
a a: Hiisäne" Sins, Suite 260 


2 Pa City 


#include <STDIO.H> 
Hinclude <WINDOWS.H> 


#include "HDI.H* 


känttr Yarloblen a R kei van aa 
extern in iCurrentPopup; vel] angezeigtes Men! 
extern int iNextPopup; ns /" Nächstes Menü B) 


Ir 
® WiMainCreateWindom( ... ) : HWND; 


szClassName Klassennamen des MDI-Haupt fensters 
Namen in der Titelleiste des MDI-Hauptfensters 
Fensterstil des MDI-Hauptfensters 
Position des linken Fensterrands 
Position des oberen Fensterrands 
Breite des Fensters 
Höhe des Fensters 
Mutterfenster des MDI-Hauptfensters 
Bezug auf Menüleiste 

nst Bezug auf Applikations-Instanz 
IpcreateParan Zeiger auf WH_CREATE-Parameter 


Lege das MDI-Hauptfenster an. Die Parameter entsprechen exakt denen der 
” “inne Funktion CreateWindow(). Die MDI-Version der Funktion hält zu- 
w ee Informationen des Hauptfensters in Wi sitz-Listen 
-Lists). Darunter fallen Bezüge auf Menüs, Abkürzungstasten und 
Mir; der sowie Zähler für die Dokument-Fenster. 


HWND ER 
LPSTR szClassName, 
szTitleName, 
IStyle, 
ann t, 
wTop, 
inth, 
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indows 


/* Bezug auf MOI-Hauptfenster */ 


hundMain = CreateWindow( szClasshame, 
szTitleName, 
hie e Top, width, wHeight 
eft, wTop, . D 
hwndParent 


Inst, 

IpCreateParam ); 
/* war es erfolgreich? */ 
if ( hundlain ) 


/* setze Systemeingriff für Wenü-Nachrichten um Tasten zu verfolgen */ 
hai Sethenskerkoskl hins t ” 

r initialisiere alle Bes iz-Verte des „Hauptfensters ij 
SetProp( hwndkai ve 


i . Getikenu( hundHain "\i 
i . LoadMenu(lhinst, "Wdilenu") ); 
hundMain 


„PROP 
celeraters Be ka I) 


ER ertech 1028 Tan Den ae 
( hwndkain, PROP Kater "iaritienane )); 
E setze Kuiptmenileiste als aktuelle Nenüleiste * 
MdiWindowlenu( hwndMain, GetMenu( hwndMain ), TRUE): 


} I ecien hwndMain; 


Ir 
s MdikainDefWindowProc( hwndMain, message, wParam, IParam ) : long; 
ee 
€ 
WORD-Parameter der Nachricht 
LONG-Parameter der Nachricht 


* verarbeitet AUCH Ichten an das MOl-Hauptfenster, die die fenster- 
® funktion der MDI- mi A für das Ha erraten rt rerking hat. 


i er Mer den Töcherfanstrn) Yrt Herfeigung. 
” * lee Menü else ist en Vberkaupt) und das vor 
aSERRT ONE HUEN: die als Yollbild dargestellt werden soll we 


MdiMainDefWindowProc( 
hwndMa i 


in, 
unsigned message, 
Vor? ge 


/* Prozedur-Instanz für Dialogfelder I} 
/" Bezug auf aktuelle Instanz */ 
/* Bezug auf aktuelles Dokument-Fenster */ 
/* Bezug auf neu gewähltes Dok.-Fenster */ 
I Verwendet beim Ermitteln der Fenster */ 
/® Fensterstil */ 

rel feat; /* Fensterinhalt des Hauptfensters */ 


bu Fr hundlain, PROP_ACTIVE ); 


case WM _ACTIVATE 
id ‚Et. MDI- Tochtertanster enthält die Aktivierung des Hauptfensters */ 
hwndActive ) 


x waram ) 
. Deaktiviere */ 
NOLUBICHINKEACHTAR hwndActive ); 
break; 

a N 


u 5 Aktivie ere ”/ 
Kaiherhatecnital hwndActive, FALSE ); 


E* 

WM_COMMAND: 
a 5 = GetWindowkord( hundMain, GWW_HINSTANCE ); 
switch ( waram ) 


case 
Deren er Tale feld *"Anzei 
Instance waidlz 


hide, hinst ); 
- hosen nel ya hinst, * 


he nenohosen =D flnhide*, hwndMain, IpProc); 


je DB wird wieder angezeigt. */ 
MdilnhideChild( hwndChosen ); 


een IpProc ); 
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N 


eg ( MEN) 
10M_HIDE, 


wParam > ar en 
m FIRSTWI SetPropl hundMain, PROP 
{ bundiai 


It: 
Deine ob Oafehl zum Selektieren eines MOl-Tochterfensters */ 
COUNT 
Sein -Hauptfensters » 


- WILL; 
hunditer = GetWindow( hunditer, GW_HWNDNEXT ) ) 


/* überspri aktives und nicht-MDI Tochterfenster */ 
if ( hunditer n =« hundActive 

! TGetProp( | hunditer, “PRoP_ IM ) ) 

continue; 


ee E "enditer, PROPNEWID ) ) 


ße zeige ein anderes MDI-Tochterfenster als aktives an */ 
f ( GetProp( hwndMain, PROP_ZOON ) ) 


MdiSwitchZoom( hwnditer, hwndActive ); 
ksinetivatschttaf hwnditer, FALSE ); 
break; 


if ( hundActive ) 
/" die anderen WM en Ta enthält das 


aktive MDI-Tochterfenster * 
return SendMessage(hwndActive, message, wParam, |Param); 


in 


in, PROP_TITLE ) ); 


lese Nie ELLE ae Se); 
Mdi FreelenukeyHoo! 
u 


er Beau "Verbergen*-Eintrag entspr. grau */ 


Iunäketiie ? MF_ENABLED : MF_GRAYED 


ia Nöcatten! [hie N] Fanstär? a. "Anzeigen" entspr. grau */ 


Enableenul 


opt hindiain, PROP_HIDDEN ) ? MF_ENABLED : MF_GRA' 


1 benötigt”das MDI-Tochtärfenster die) er ch auch */ 
if (u alien! 


SendMessage( un message, „Paran, |Param ); 


case W. “inımmemupoPUP: 
jr verfolge, welches Menü aufgeklappt ist, sodaß beim Drücken der 
linken oder ur Richtungstaste klar ist, welches das nächste Menü ist */ 


if 


( KIWORD( IParam 
iCurrentPopup = POP_MAINSYS; 


else 


f 


a [erst berdaın. PRos zoll) ) 


( bundActive ) 


/* wöglicherweise benötigt das MOI-Tochterfenster die Nachricht */ 
SendMessage( hundActive, message, wParam, |Param ); 


case wm ke 


if 


HAR: 
(Param == '-' ) 


4 stelle Stevermenü des aktiven MDI-Tochterfensters dar */ 
f ( ( LOWORD( IParam ) 3 Mf_POPUP ) =» O && hwndActive ) 


I" IeeN das MDI-Tochterfenster im Vollbild? */ 
if ( GetProp( hwndMain, PROP_ZOON ) ) 


/" WOl-Tochterfester-Steuermenü ist in Haupt-Menüleiste */ 
return MAKELONG( 0, MC_SELECT ); 


Int = POP_CHILDSYS; 
/" als is wird Krope ieh Er. mus ehr 
han che ehten-Aufruf 


u es nn ia 
en rat 0, MC_ABORT ): 


k; 


k; 
case MM ı SETFOCUS: 
/" setze den Fokus des no -Hauptfensters als Fokus des aktiven 


if ( 


MDI-Tochterfensters * 
tive ) 


SetFocus( hwndActive ); 
ki 
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case WM_SIZE: 
it (mParam I= SIZEICONIC ) 


j a Teer er ters wenn Vollbild */ 


Getchi hundMain, SreCli 
Karl ac f vw, In sm SINE ); 
Berakndn esdketve Es IStyle, FALSE ); 


t - rcClient.left, 
Keim tom - reClient.top, 
; 


} 
ER 
return DefWindowProc( hwndMain, message, wParam, IParam ); 


I" 
dl = MiChildCrenteWindow( . -) : UND; 


Klassennamen des MDI-Tochterfens 

Namen in der Titelleiste des et in 5 RER 
fensterstil des MDI-Tochterfens 

Position des linken terra 


Bez ar wi Hauptfens 
au - 
Bezus auf Menüleiste des Do Dokuments 
Bezug auf Applikations-Instanz 
Irasfüien Teer auf WM_CREATE-Parameter 


nd Kr ein 7 Dirndyg wrt Tochterfenster an. Die Parameter entsprechen exakt 
ndows-Funktion CreateWindow bil 


et Menüleiste ist 
* Yochlarn TetneiPfkarton erwartet. Die 


hd el Informationen des Hauptfensters in Wi 

" Byrista)- Darunter fallen Bezüge auf Menüs und Abkürzung: 

# en se ein Flag, ob das Tochterfenster tatsächlich © oa 
:e "Dokument ist. 


wm... 


HUND MdiChildCreatektindow( 
LPSTR szClasshame, 


Mi Tivestalstan-Tage des Dokuments */ 

/* Verwendet beim ren ee “ 

” TOEESLTRBESATTÖRRENE tion ®, 
/* Position des linken SER EI 
/* Position des oberen Fensterrands */ 
I" Etat 0. Aero “ 
/* Höhe des u} 

/* Bezug auf Ari berwment- Fenster */ 

/" Bezug auf Dokumentfenster */ 

rechient; /* Fensterinhalt des MOl-Hauptfensters "/ 


Berechne Größe und Position */ 


= GetProp( hwndNain. PROP COUNT ); 
reg EFÄUL ’ 


dthAct = 200; 
ve rg w= CW_USEDEFAULT ) 
t = 75; 
nnerhalb des Fensterinhalts steht */ 


wei 3 
nTop = USEDEFAU 
wrophet > Teller. bottom 
one 2“ t.bottom; ) 


aanfen ” Penn szClassHame, 


szTitlelame 

IStyle, 

we Bat, wi widthAct, wHeightäct, 
lopket, gh 


a "| iCommt, 


R rrarfeigelar m 
5 Prop| Pe bR0e Lou ++iCount ); 
ini e x 


ir alisiere 1rof Daten */ 
Sat CHILDMEM) „eenschi1d ) 
an hwndChi 1d, PROP 


SetPropl hwndchild, PROP-MEMIID, IÖM FIRSTWIN + iCount ); 
SetProp| hwndChild, PROP-ISMDI, TRUE"); 
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ar Rare Fear Fee Re Tat “ 
L Ki ner £ a als HE); fenster */ 
( es ER ur ) 
BEL 
stelle ste neu ” 
} Dramienußar( hundMain ); 
return hwndChild; 


MdichildDefWindowProc( hwndChild, message, wParam, IParam ) : long; 


Bezug des MDI- sr 
raseter der Nachricht 
VOR-Paramster der Nachricht 


* verarbeitet Nachrichten an ein MDI-Tochterfenster, die die Fenster- 
ri DUSEtYen der MDI-Applikation für das Hauptfenster nicht verarbeitet 


ERINT RT Fü 


"/ 

MdiChildDefwi nee ee { 
unsigned message, 
WORD wParam, 
LONG IParam ) 


HWND hwndHain; /* Bezug auf MOl-Hauptfenster */ 
PAINTSTRUCT Paint; /* Zeichnen-Struktur */ 


hwndMain = GetParent( hwndChild ); 
awitch ( message ) 


case WM _CLOSE: 
/* Fenster wird geschlossen */ 
rin ein hundchild ); 


case WM_COMMAND: 
switch( wParam ) 
case IDMMIDE: 


I F 7] 
eat Ameise): 


case IM _RESTORE: 
Fer hwndChild, WM_SYSCOMMAND, SC_RESTORE, IParam ); 


case IDM MOVE: 
SendMessage( hundChild, WM_SYSCOMMAND, SC_MOVE, 1Param ); 


break; 
case I0M_SIZE: 
SendMessage( hwndCchild, WM_SYSCOMMAND, SCSIZE, 1Param ); 


break; 
case IDM_MAXIMIZE: 
SendWessage( hwndchild, WM_SYSCOMMAND, SC_MAXIMIZE, IParam ); 


case IM PREVWINDOW: 
/* Dieser Aufruf erfolgt nur über die sn “/ 
eniinesget hundChild, WM_SYSCOMMAND, SC_PREVWINDOW, 1Param); 


break; 

case 1 NEXTWINDOW: 
/* Dieser Aufruf autolst.n nur über die Tastatur */ 

reg ae hundChild, WM_SYSCOMMAND, SC_NEXTWINDOW, 1Param); 


k; 
case WM_NITMENI: 
ee bmndchild ); 


’.' 1 ; fgek! “ 
1 Bra.) Tate met, Ar DaiR Fed aufgeklappt war? */ 


if ( waram == '-' ) 


/" Alt-Minus bleibt aktiv im Stevermenü */ 
return MAKELONG( O, MC_SELECT ); 


else 
/* Andere Be re Verwaltet das MDI-Hauptfenster */ 
u . 
(DWORD ) Para ); 
y tern NAKELONG( 0. MC_ABORT ); 


brent; 


“ecarrenopap = POP_CHILDSYS; 
are 


se MOUSEACTIVA 
Te hmndchitd, FALSE ); 


WM_SYSCOMKAND: 
a wParam A OxFFFO ) 
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ai KEYMENU: 
if srl hwndMain, PROP_ZOOM ) |} LOWORD(1Param) I= '-' ) 


/* Schicke andere Alt-Tasten-Nachrichten an Hauptfenster */ 
return Sendlessage(hwndMain,W#_SYSCOMMAND, wParam, 1Param); 


a Se haınıze: 
f ("SetProp "hwndHain, PROP _Z00M ) ) 


a Ach de HRie Hr 1 


ri se 


" Surprnf,Ire ae: VE ra WE 


return OL; 
case SC_RE 
if ("SetPropt hwndMain, PROP_ZOON ) ) 


PROP_ZOOM, FALSE ); 
Pe Be 


ae OL; 


SC_NEXTWINDON: 
“n re Aufruf erfolgt or über die Tastatur */ 
HdiActivatelextChild( hild ); 
return OL; 
case SC_PREVWINDOW: 
/* Dieser Aufruf erfolgt nur über die Tastatur */ 
MdiActivateprevChild( hild ); 
return OL; 


reak; 


} 
return DefWindowProc( hwndChild, message, wParam, IParam ); 


Ir 
= HdiGetHessage( hwndMain, IpMsg, hund, wMin, wHax ) : BOOL; 


Bezug des MDI-Hauptfensters 
Hachrichten-Struktur zum Empfang der Nachricht 
Sind Nachrichten nur für bestinstes Fenster? 
Gibt es einen Mindest-Nachrichtenwert? 

Gibt es einen Maximal-Nachrichtenwert? 


Liest eine normale Fensternachricht erst dann 2 de geprüft wurde, 
Fr über die Tastatur auf die Menüs zugegriffen wird 


BOOL HdiGetMessa 
HWND ee n, 


/* Realisiere Tastaßr-Iatar hack von Menü */ 
iMenuMessa IR ieh ic n) i 

" Lese ansc nd = se Kachei Er 

return eeanaeal hund, win, wHax ); 


Ir 
» KdiTranslateAccelerators( hwndMain, IpMsg ) : int 


sun Bezug des MDI-Hauptfensters 
IpMsg Nachrichten- Struktur der aktuellen Nachricht 


Übersetze die karlars über eine der beiden folgenden 
Abkürzungstasten-Tabellen 
1) Dokument-Steuermenü (' (2. B. <ctri>+<F4>) 
* 2) Die eigene OKI man sas tan Tanel1s des Dokuments, die mit der 
. Funktion MdiSetAccelerator() gesetzt wurde. 
int MdiTranslateAccelerators( 
i 
{ 
int jResult = 0; /* Ergebnis der letzten Übersetzung */ 
TABLE hAccel; /* Eine der beiden Abkürzungs-Tabellen */ 
hwndChild; /* Bezug auf Dokument-Tochterfenster */ 
/* Bestimme aktives Bobemeits falls zerkenien Y 
hundchild = TIER in, PROP_ACTIVE ); 
r ( hwndchild ) 
/* Prüfe, A Stevermenü-, BERREANOR Tasten “ 
hAccel = hwndMain, PROP_CTR! 13: 
WÜH - ae ateAccelerator( Be hAccel, IpMsg ); 
i iResu 
b Bern dokumentei Abkü ee “ 
Metal ee . Om e an Shoe rzu 3 ’ 
Meet 
iResult = ARTNET hwndHain, hAccel, Iplisg ); 
} 


return iResult; 
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Windows 


I" 
Id z wi2.c - Child Window Routines 


” * Programiers sche: Microsoft-C 5.1 
ichermodell: medium 

” Ehtuicklosesumabänig: Microsoft Windows 2.1 SDK 

« „ Status: einsatzfähig 


® ® Dieses Modul enthält den gesamten MDI-Code zur Verwaltung der Aktivie- 
* rungen zwischen den MOI-Dokument-Fenstern. Es enthält such die Vollbild- 

* darstellung und Arge nn der Dokumente und insbesondere das Um- 

* schalten zwischen den Fenstern. Weiterhin befindet sich hier der Code 

id für das Dialogfeld des Befehls "Anzeigen". 


” * Entwickelt von: 

* Geoffrey Nicholls 
4 Kevin P. Welch 
Pi 


c Sauyr the ht n. 
” : Br A, 1 dal "Sivd Suite 260 
» Hillsdale 
Fa City CA 94404 


#include <STDIO.H> 
#include <STRING.H> 
#include <WINDOWS.H> 


#include "MDI.H” 


ir 
> MdiDestroyChildwindom( hwndChild ) : void; 
hwndChild Handle of document window 


* 

. 

* Diese Funktion wird aufgerufen, wenn ein Dokument-Tochterfenster 

* geschlossen wird. Sie nimmt ein anderes Dokumentfenster und aktiviert es. 
n kein anderes Dokumentfenster verfügbar (sichtbar) ist, wird die 

= » Original Nentleiste des MDI-Hauptfensters angezeigt und der Fokus dem 

E7VERBERIE zugewiesen. 


void HdiDestroyChi IdWindow 

f HWKD hwndChild ‚ 
hmenuMain; /* Bezug auf MDI- Hauptfenster-Henüleiste "/ 
hmenu0ld; /* Bezug auf Dokument-Menü */ 


hwndNext; /* Nächstes aktives Dokumentfenster"/ 
hwndMain; /* Bezug auf MOI-Hauptfenster */ 


bi Entferne das Dokument aus dem AFOnBEST- Han ”/ 
MdiRemovewindowF romlenu: hwndChi 1d, T 

/* Wähle ein neues MDI- ochtertensier a on "das aktiv werden soll */ 

hwndHain = GetParent 4; 

hwndNext = MdiChoosel anchi d{ hwndchild ); 

if ( hundNext ) 


k Aktiviere dieses MDI-Tochterfenster */ 
f ( GetProp( hundHain, PROP_ZOOM ) ) 


MdiSwitchZoom( hwndNext, hwndChild ); 
iActivateChild( hwndNext, FALSE ); 
else 


/* Kein anderes MOI-Tochterfenster ist aktiv */ 
if ( GetProp( hwndMain, PROP_ZOOM ) ) 


SetProp( hwndMain, PROP_ZOON, FALSE ); 
WäiRestorechild( hwndchild, FALSE ); 


* Zurück zur Menüleiste ohne "Window" -Henü */ 
Id = GetMenu( hwndMain 


hundlain, "PROP_HALNME WW); 
in, BEIN. "TRUE ); 


in, hmenuMain ); 
hwndMain hmenvöld, Ab ); 
Se in, PRop" ACTIV L); 

/* Fokus wieder zum Ko-huuptfünster 7 
Setfocus( hwndMain ); 


h. zZ Verände "/ 
Dradlenabar( hmdhaln ) 


Jr 
2 MdiActivatechild( hwndChild, bHidden ) : void; 


hwndChild Bezug auf Dokument-Fenster 
bHidden War Dokument-Fenster vorher verborgen? 


ktiviere das angegebene Dokument-Fenster. Es erhält die Min 
itelleiste, es wird als oberstes Tochterfenster angezeigt, sein 
Menü wird als MDI- Hauptfenster-Menü gesetzt etc. 


a 
void aaa 
HWND 


f BOOL 
{* Vorherige Dokument-Menüleiste */ 
HMERU ‚New; /* Wenüleiste dieses Dokuments */ 
HHENU $ /* *Fenster"-Menü */ 
HWND /* Bezug auf vorheriges Dokument */ 
/" Bezug auf NDI- Hauptfenster “/ 


hwndMain; 
LONG IStyle; r Fensterstil des Dokument-Fensters */ 


Listing 3: Aktivierung und Umschalten der Dokumente 


Microsoft System Journal 23 


Prüfe, ob dieses Tochterfenster bereits aktiv */ 
in = GetParent( hwndChild N 
Getwi hundChi} a} STYLE ); 


ürbe = EL) a 
« MANCACTINATE, TRUE, OL); 
ildfeld der Titelleiste hinzu ir 


ep Busen yon 


f ie bHidden ) 
er hunlentTas sd ): 


N "ie Setze Fenster als oberstes und zeichne Rahmen neu ”/ 
SetWindowPos( 1d 


WLL.O, 0, 0,0, 
SWP_ORÄWFRAHE | SWP_NOMOVE | SWP_NOSIZE ); 
Aktiviere das Tochterfenster */ 


tive hndain. PROPACTIVE ); 
M ee Re 


{* Entferne Aktivi tails vom vorher aktiven Fenster */ 
# ( ImndActive 88 tive I= hundCchild ) 


Wdideactivatechild( hundActive ); 


Setze gülti Bontlaiste: are dieses MDI-Tochterfenster */ 
- hwndChild, PROP_CHILDMEN ); 


Bali TRUE ); 
ee }i 
Kalender Iundhatn, hmenuold, FALSE ); 


Fig Das ee ee ze st u aktiv Bein, 
SetProp( in, PROP_} 4); 


hd ho das neue Fenster in der Liste des *Fenster*-Henüs */ 
"Ge Sei n. PROP_WINDOWMENU ); 


I u; neue Tochterfenster ” Ike den Eingabefokus haben */ 
if ( GetFocus( ) i= hmndchil 
; SetFocus( hundchild ); 


I" 
= MdihetivatelextChild( hwndChild ) : void; 
5 bndchild Bezug auf aktuelles Dokument-Fenster 
* Aktiviere das nächste Fenster in der internen Fenster-Liste. 
RR Funktion wird aufgerufen, wenn <Strg>+<F6> eingegeben wird. 
void Ya se 
f HWND hwndChild 
I® eos ud f vorheriges Dokument */ 
/* Bez: u bei der Fenster-Auswahl */ 
” Frei auf MOl-Hauptfenster */ 
for ( Malte 1e en hwndChild, GM_HWNONEXT ); 
hunditer = Getwindow( hwndIter, GM_HWNONEXT )) 
{ 7P’kiem nächstes sichtbares MD wOi-Tochterfenster in der 
er internen Fensterliste des Windows-Systens 
( GetProp(hwnditer, PROP_ISMDI) 88 IsWindowWisible(hwnditer) ) 


) break; 


I Kate ein ae MDl-Tochterfenster gefunden? */ 


hracttye Faire] Ram Zmalter Ihe. 
GetProp( hundMain, oe on} 
Le Aktiviere das or Feier. ter x 


Wale vakE 4 huna Munster FALSE su 
tz: Ende der internen fensterliste */ 


ACTIVE ); 


. Se SMP_WOSIZE | SWP_WACTIVATE ); 


] 
Ise 
{ /* Setze Fenster ans ee der internen Fensterliste */ 
“ie er. 
0, 0 
OR E | 
/* Äktiviers das neue fen 
haihetivatachriäl sitter FALSE ); 


Sup BOauE } ELSE PREE ); 
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/* 
je Miiketivateprevchild( hundchild ) : woid; 
1 bundchild Bezug auf aktuelles Dokument-Fenster 
* Aktiviere das vorherige Fenster in der internen Fenster-Liste. 
a Funktion wird aufgerufen, wenn «Strg>+<Umsch>+<F6> eingegeben wird. 
void a Ne 
f WIND hundChild 
hundActive; Fe ug auf vorheriges Dokument */ 
hwnditer; ” Bezug bei der Fenster-Auswahl */ 
bundkMain; r Bezug auf MOI-Hauptfenster */ 
for ( Alchundisar a hwndchild, GW_KWNDLAST ); 
hwnditer = Gethindow( hwnditer, GM_HWNOPREY ) ) 
ja Kim nächstes sichtbares ger Ara arg in der 
internen Fensterliste des Wi ee re “/ 
fr ( GetProp(hwnditer, PROP_ISMOI) &8 sWindowisible(hwnditer) ) 


break; 


$ rn ein MOI-Tochterfenster gefunden? */ 
hunditer = 
* Aktiviere das neue fenster I 
Krone ee PROP_ZOOM 
MdiSwitchZoom( hwndIter, hwndActive ); 
en hwnditer, FALSE ); 
} 


” » MiDeactivatechild( hwndchild ) : void; 
: Iundchild Bezug auf Dokument-Fenster 


m Sa das Dokumentfenster zurück, weil entweder i 
elleneer aktiv aktiviert wird oder die Applikation ES Eisase: 
2 feks Eee rer 


void Miißsectivetschilgl 
HUND hwndChild ) 


\ LONG IStyle; I" Fensterstil des Dokument-Fensters */ 


* prüfe, ob das BDI Tochter Teerhr bereite deaktiviert ist */ 


Re HT TeyIe Seelze) En BERN 


/* Wechsele die Farbe ae Titelleiste */ 

SendWessage( hwndChild, WM_NCACTIVATE RE 

/* Entferne Steuermenü u VorTortareld aus egeotrlielieiste */ 
Setkindonlong( hundchi1d, 


Tr a wemzunn | WS_SYSHEW ) ); 
PAD Ubmnächild, u, : 


SB -OTORDER )» 


“Menü */ 
Eee). bundChild ). PROP_WINDOWMENU ), 


fr 
z WdiZoomCchild( hwndchild ) : void; 
: hwndChild Bezug auf Dokument-Fenster 


4 Mirugtt Dokument i ten Zeichenbereich des 
. MOI-Hau; pen ade äh ig “iR und die rg ale 


gebracht, ng & Funktion du er 
» Zai chankeret ch des Dokuments in den Ze ie iR It tfen- 
ar und den Titel des Dokuments in on u leiste des Hauptfensters. 


void MiiZooschild( 
AWO hundchild ) 

szTitle 128]; /* Text für Titelleiste */ 

szHain /* Text für Nicht- Yollbild-Titelleiste uf 


szchil, j: ür Dokument-Titelleiste */ 
hundiMa in rd 


Istyle; 

Iplei /* Fensterinhalt des MDI-Hauptfensters */ 
/* Wechsle die Menüleiste ”/ 
hwndHain = GetParent{ hwndChild ); 
in a op hwndChi Id IE 


awenußar| hwndMain 
/* Ändere die Titelleiste / 
GetAtomlame( GetProp( hwndMain, PROP_TITLE ), 


Er n 
sizeoflszHain) y; 
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Windows 


/* NEUES Dokument-Fenster */ 
Fl Eimiteie- 2lcnnd ae ateees Fensters im Zeichenbereich */ 


Getki eClien 

Sereunteiltent Yale Farraid’ BreClient+0 

tn SR Ste PPOINT ) ärcClient+l 
> "FEclNen u ); 


Setprob beodnenı PROP-TOR lien 

SetProp hwndNew, a, Feelient wi, - reClient.left un 
SetProp( hwndiiew, PROP”HE IGHT, rcClient.bottom - reClient.top 
de Repositioniere das neue Fenster */ 

SReCH TEE aSeParent bunden r At 2 

1Style = f; IL_STYLE 

Kjlstvindoer t{ läd ient, Meile FALSE 

SetWindowPos ee: 


hi id. Hl 
LPPOINT "grcclient+O 
hwndMain, ( LPPOINT ) ärcClient+l 
Hd PROP_LEFT, BER er % 
zeieren hwndChild, PROPTTOP, reClient.top 
SetProp( hwndChild, DEN DIA, reClient. Prilke - reClient.left ); 
SetProp( hwndChild, PROPHET Torf, rcClient.bottom - rcClient.top IF 
/* Positioniere das Fenster so, "daß sein Zeichenbereich den gesamten 
Zeichenbereichs des HDI- Dr belegt */ 
GetClientRect( hwndMain, ArcClien wi 
1Style = Get! eg hwndchi ld STYLE ); 
Mdjustindowiert( Arc (lient, IStyle, FALSE ); 
SetWindowPos 


(ettent.1ef et, reClient.t: 
reClient.ri ht - reClient.\eft, reClient.bottom - reClient.top, 
SWP_HOACTIVATE }; 


SWP_| 
je Setze den VollbiidFensterstt]. 3/ 
SetWindowLong( hwndNew, GWL_STYLE, 1Style | WS_HAXINIZE ); 
/* Aktualisiere Menü Sf 
MdiZoomllenu( hwndNew 
/* Zeige das neue Fenster ie 4 


Showkindow( hwndiew, SW_SHOW ) 
/* Der Zeichenbereich ist dern ler alten Fensters */ 
(N CT ) WLL, TRUE ); 


LL, 
reClient.left, reClient. 
rcClient.right - reClient. eft, reClient.bottom - rcClient.top, 


0° 
I" Se Ye den Fensterstil "Vollbild" */ 
SetWindowLong( hwndChild, GML_STYLE, IStyle | WS_MAXIHIZE ); 


MdiRestoreChild( hwndchild, bHidden ) : void; 


hwndChild Bezug auf Dokument-Fenster 
bShowklove Soll das Fenster angezeigt bleiben oder verborgen werden 


Ange das angegebene Dokument von der Vollbilddarstellung zurück in 
" die Darstellung zuvor. Das Dokument wird mit der Größe vor der Voll- 

* bilddarstellung an die entsprechende Position plaziert. Diese Werte werden 
* aus der Besitzliste ermittelt. Weiterhin wird die Titelleiste des MDI- 
nen wiederhergestellt. 


tz 
St @ = GetWindowLong( Ve ne 
'indowLong( hwndCur, GWL_STYLE, Isle N Aus MAXIMIZE ); 
[% Verschiebe Fenster dorthin, wo es vor der YoTlbild- Darstellung war "/ 


SWP_| 
jr Aktaslislere FAR wu 
void BöiRestoreck dk MdiRestorelenu( hwndCur ); 
ng hmndChild, 


char szHain[128]; /* Text der „Michtn Vollbild-Titelleiste */ 
HWND hwndMain; /* Bezug auf das MDI-Hauptfenster */ 
LONG Style; /" Fensterstil des Dokument-Fensters */ 


/* Wechsele die Menüleiste */ 

hundMain = Get ta Kr er 4); 

MdiRestorellenu( hwn: 

Dranfenußar( hwndHain li. 

& aealle Trealisiste s Applikationsfensters wieder her */ 
FAXE GetProp( hwndMain, PROP_TITLE ), 


{ Ir 
* MdilnbideChild( hwndChild ) : void; 


x hwndChild Bezug auf Dokument-Fenster 

* Entscheide, welches Dokument als au aktiviert wird, wenn das 
En geschlossen oder verborgen wi 

HWND MdiChooseNewäctivechild( 

f HWRD hwndChild ) 

HWND hwndIter; /" Bezug auf Fenster beim Aufzählen */ 


/* Bestimme ein neues MOI-Tochterfenster für die Aktiverung */ 
indow( hwndChild, GW_HWNDFIRST ); 


sizeor] szHain ) ); 
7 ihres ext( hwndMain, szHain % 
Setze Fensterstil auf normale Auper I 4 
Isıylen, ” a aen? re L_STYLE ); 
hwndChi ld, STYLE, De & Aus) MAXIMIZE ); 
I" era rn falls tasche = 
if ( !bShowlove ) 


Showtindow( hwndchild, SW_HIDE ): 


h. Bewege Fenster zu der ursprünglichen Position in entsprechender Gi u £ 
/* Setze es ran den Besten der internen ee Be ringe er 


4, 


/* Nimm das nächste sichtbare MDI- Techtertüsnter in der internen 
Fensterliste, welches nicht das aktuelle ist */ 
MmdI tar PROP_ISHOI ) 


88 IswindowVisible( hwnditer ) ) 


break; 
« PROP_LEFT ), 


PROP_TOP I, 
PROP_WIDT| 


} 
return hwndlter; 
} PROPTHEIGHT % 


} 


I 

» Ndihidechild( hwndChild ) : void; 

a IwndChild Bezug auf Dokument-Fenster 

* Verberge das Dokument-Fenster. Diese Routine aktiviert auch 
” das nächste verfügbare Fenster. Wenn kein weiteres Dokumentfenster 


* existiert, wird die Original-Henüleiste des MDI-Hauptfensters gesetzt und 
a Fokus diesem Hauptfenster zugewiesen. 


MdiSwitchZoom( hwndNew, hwndCur ) : void; 


hwndChild Bezug auf neues Dokument-Fenster 
hwndCur Bezug auf bisheriges Dokument-Fenster 


Diese Routine wechselt die Aktivierung zwischen zwei Dokument-Fenstern, 
wenn das ‚nlcherige Dokument-Fenster als Vorbild darstellt wird. Bei j 

* Wechsel ist die Reihenfolge der ARUINEECRG wichtig. Wenn die Dokumente 

* Vollbilder aid. je es wichtig, nicht dem gewöhnlichen Ablauf zu tier 
" sonst ist.es ich, daß man Maeeg Bein Wechseln ein Nicht-Vollbild- 
er a sieht, bevor das neue Dokument den Zeichenbereich ganz ausfüllt. 


nm... % 


{ 
I" che verborgener Dokumente */ 
/* Bezug auf MDI- Snoptfenster-Nenüleiste el 
/* Bezug auf Tochterfenster-Henüleiste */ 
/" Bezug auf MDI-Hauptfenster */ 
/* Bezug auf nächstes aktives Dok.-Fenster */ 


/* Ein MDI- Tochterfenster Kenaehtig"); ist sichtbar */ 
hwndMai 


void BOISUIEChEömE 
KWND hundNew, 
hwndCur ) 


szTitle[128]; /* Text für die Titelleiste */ 

sch sl /* Text für die Nicht-Vollbild-Titelleiste */ 

szChild[12} 1: /* Text für Dokument-Titelleiste */ 
hwndMain; /* Bezug auf MOI-Hauptfenster */ 

1style; I* Fonstersti] des Dokumentfensters */ 

reClient; /* Fensterinhalt des MOI-Hauptfensters */ 


/* Wechsele die Tiegpeiste, Ei 
tProp| hwndMain, PROP_TITLE 
szMain ) 
sizeoflszMain) ); 
GetWindowiext( hundiiew, uns sizeof u 38 


sprintf( szTitle, "%s - szMain, szChild ); 
SetWindowText( hwndMain, htle) ); 


{ 


N romlenu( une machtia FALSE 1A 
ra Finde Se pe aktives MDI-Tochterfens 2 ’ 
bwndNext = MdiChooseNewActiveCchil nes 
/* Bringe die Fenster in die neue erh 
if j hwndNext 
(IE u ein anderes Fenster zur Aktivierung gefunden */ 
if ( GetProp( hwndMain, PROP_ZOOM ) ) 


MdiSwitchZoom( hwndNext, hwndChild ); 
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Showkindow( hwndChild, SW_HIDE 
WdiActivatechild( hwndhext, FALSE ); 


Ise 


Verberge das letzte MDI-Tochterfenster */ 
ee, Prop( hwndMain, PROP_ZOOM ) ) 


( hundlain, PROP_ZOOM, FALSE ); 


KöiRer orechild( "FundchT1d, FALSE J; 


indow( hwndChild, SW LMIDE 1; 
Fir RE 2. auuraertegliche Mes Henü eiste (ohne "Fenster"-Henü) an */ 


hmenuMain = Get! hundkain TE ap MEN ; 
TWindom Fr in, Mmeninain, TRUE ); A 


ukain 
Bundkain, big, use ): 
erraten besitzt jetzt den Eingabefokus in 


Eich 


Fidl 
» KdilnhideChild( hwndCchild ) : void; 
si hwndChild Bezug auf Dokument-Fenster 


a ein vorher verborgenes Dokument wieder an, 
void MdiUnhideChild 
HWND handknina ) 


int iCount; /* Anzahl der verborgenen Dokumente */ 
HWND hwndHaın; /* Bezug auf MOI-Hauptfenster */ 


/* Ein MOI-Tochterfenster mehr ist sichtbar */ 


an ®/ 
haißeinsertwindoninkenuf hwndchild ); 
/* Das Fenster wird aktiviert */ 
if ( GetProp( hwndMain, PROP_ZOOM ) ) 


MdiSwitchZoom( hwndChild, GetProp( hwndMain, PROP_ACTIVE ) ); 
iActivateChild( hwndCchild, TRUE ); 


ir 
 MdiDlgUnhide( hwndUnhide, message, wParam, IParam ) : int; 
hwndUnhide Bezug auf Fenster des Dialogfelds 
übe: Nachricht 


WORD-Parameter der Nachricht 
IParam LONG-Parameter der Nachricht 


* Verarbeite die Nachrichten des Dialogfelds "Anzeigen". Die Routine geht 

* davon aus, Se die Dokument-Fenster unterschiedliche Titel-Namen besitzen. 
* Wenn utzer einen Titel im Verzeichnisfeld auswählt, sucht die 

* Routine das esistierande Dokument als Fenster mit dem gleichen Titel. 

Ben wird dann wieder dargestellt. 


int FAR PASCAL MdiDIgUnhide( 
HWKD hwndUnhide, 

message, 
'aram, 

IParam ) 

select /* Titel des Dokumentenfensters */ 

sSelec 80]; /* Ausgewähltes Dokument in dem Verz.-Feld */ 

/* Index innerhalb des Verzeichnisfelds */ 


Ka /* Bezug auf Fenster beim Durchzählen */ 
hwndMain; /* Bezug auf MOI-Hauptfenster */ 


switch ( message ) 


case er AHLIUAALDE: 
fr . Foren ander ‚mi: Tethtertanster in das Verzeichnisfeld */ 
hundnain - ge hp Iinhide 
for ( hunditer a tet opWindom( Beihain ); 
hwnditer != NULL; 
hmndIter = GetWindow( hundIter, GW_HWNDNEXT ) ) 


I" ar nicht-MOI et ettere Fenster */ 
if (15 (_hwndite I 
N Pe rerbiet ndtar )) 
continue; 
* Ein mögliches Fenstr zum Wiederanzeigen */ 


GetWindowlext( hwnditer, izle, sizeof| sTitle ) ); 
SendD] m ge( hwndUnhide 


("LONG ) ( LPSTR ) sTitle ); 
/* wähle das erste MOI-Tochterfenster in dem Verzeichnisfeld aus */ 
TE" sage( hundUnhide, DLGUNHIDE_LB, LB_SETCURSEL, 0, OL ); 
urn 


“ent Noaree ) 
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" en MOI-Tochterfenster wurde im Verzeichnis ausgewählt? */ 
aus HR ) SendDigItemlessage( hwndUnhide, 


1B, 
;_GETCURSEL, 


hi = 
if ( ilndex LB_ERR ) 
Ben hwndUnhide, WLL ); 


bestimme den Titel des ausgewählten MDI-Tochterfensters */ 


SendDigItemles: hwndUnhide, 
DLGÖNKTDE NT 


LB_GETTEXT, 


ONG ) ( LPSTR.) sSelected ); 
vergleiche den Titel wi Aue) MDI-Tochterfenstern */ 


Ba uähain ): 


/* Öbergehe nicht-MDI oder stchihäre Fenster */ 
if ( 1GetProp( hundIte SKDI 
yTskingwvistble( "hunditar ) ) 


a 
” Eines der versteckten Fenstern wurde ge 3% 
GetWindowText(_hwnditer, sTitle Sizoll te ) 
if ( stremp( sTitle, sSelected j. 


/* Das Fenster wurde gefunden. Dies beruht auf der Tatsache, 
keine zwei MDI- MTochterfenster den gleichen Titelnamen 


PT 
EndDialog( hwndUnhide, ( int ) hmndIter ); 
return FALSE; 


h. Kein Mar Torkier fenster Tu "/ 
Drdaialont hwndUnhide, WILL ); 


case IDCAMCEL: 
EndDialog( hwndUnhide, WILL ); 
break; 
, DLGUNH 
\ eriek im VOEze Rat ataln. bewirkt das gleiche wie OK */ 
Ki WORD( IParam ) == LBN_DBLCLK ) 


SendHessage( hwndUnhide, WM_COMMAND, IDOK, OL ); 


} 
return FALSE; 


Listing 3: (Ende) 


I" 
R » hol3.c - Menu Handling Routines 
2 er ehe Microsoft-C 5.1 
medium 


” 3 ErteiekTungsugebung: Microsoft Windows 2.1 SDK 
= einsatzfähig 


" Dieses Modul enthält den gesamten MDI-Code zum Verwalten der Henüs. Hier 

" wird das Dokument-Steuermenü in die Menüleiste des 1a herigee einge- 

® fügt und auch wieder entfernt. Weiterhin werden die Titel er neu erzeugten 
" oder wieder angezeigten Dokumente in das "fenster"-Menü aufgenommen und 

" entfernt, wenn sie zerstört oder verborgen werden. Wird zwischen Dokumenten 
2 umgeschaltet, wird auch die Markierung im "Fenster" -Menü umge eha tet. 

“ ließlich wird hier das seiste der Menü-Tastatur-Schnittstelle 

a realisiert. 


* Entwickelt 


Geoff: We chol Is 
Kevin P” Welch 


c ah ht 1988 

a: ® gas, 1 Inc 
"989 E. hilisdate Bivd, Suite 260 
Foster City CA 94404 


u Anpassungen: Marcellus Buchheit 


#include <STDIO.H> 
#include <STRING.H> 
#include <WINDOWS.H> 


#include "MDI.H” 
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Windows 


/* statische Variablen ul 
static FARPROC 1 Hook; 
static FARPROC 1DO1dNsgook; 


Ne 3 ade Verein „BA 2 Eee AR 
Popup = NONE; s ist angeze 
im HskPopup = = POP_NORE; /* Welches Menü ist er ER ste ', 


/* für den Menü-Systemeingriff */ 


I" 
* NdiZoomlenu( hwndchild ) : void; 
24 hwndchild Bezug auf Dokument-Tochterfenster 
* Passe das Dokument-Henüleiste an, indem das Stevermenü aufgenommen wird. 
SP erfolgt, wenn ein Dokument als Vollbild dargestellt wird. 
void NdiZoomklenu( 
( HWND hwndchild ) 

HBITMAP hBitmap; /* Bezug auf Stevermenü-Rasterbild */ 
HMENU) en I® Pe auf Stevermenü */ 

/* Bezug auf MOI-Hauptfenster */ 

/* Andere das Menü */ 


hwndHain = Bank hwndchil 
hmenuSystem = eig BEL LGITeNSE Mn 


Ehngchenu( Getrep Pd KERCRT1T PROP HILL ), 
(str ) ( DwoRD ) heitaap, 
Mr KT j "MFL_ BYPOSITION | MF_INSERT | MF_POPUP )i 


MdiRestoreMenu( hwndChild ) : void; 
hmndchild Bezug auf Dokument-Tochterfensters 


“ Passe die Dokument-Henüleiste an, indem das MOI-Steuermenü entfernt wird. 
Fang erfolgt, wenn ein Vollbild-Dokument wiederhergestellt wird, 


oid MiRestoreke 
a 1a) 


/* Ändere das Menü */ 
FRRRDURR u( GetProp( hwndChild, PROP_CHILDMENI ), 


"LPSTR ) WLL, 
ME_BYPOSITION | MF_REMOVE ); 


I" 

x NdiAppendWindowenu( hwndchild ) : void; 

= hmndChild Handle to document 

* Füge den Titel des neu angelegten Dokuments in das "Fenster"-Menü ein. 


* Der Inden wurd berechnet, Tod die Anzahl der Einträge des Menüs 
5 


void ABI genN) Hark 
{ 


ilndex; /* numerischer Index für *Fenster”-Menü */ 
szCurrent 50]; } 

seTet [fl 9 */ 

hwenuchild; /* Die Menüleiste dieses Dokuments ha 
hmenuWindow; /* "Fenster"-Men 

hwndMain; I" Bezug auf Molehauptfonster nd 


” Ermittele wichtige Daten * 
dMain = GetParen } hwndChi 
hmenuchid = « GetProp hundchi1d, pop ChILOMEN) FE 
= GetProp( in, ai 
fige es rei ech rator-Linie ein */ 
Ir ( GetMenultemCount( hmenuWindow ) == WINDOW_POS - 1 ) 
ChangeMenu( hmenuWindow, 
MLL, 
MF_APPEND | MF_SEPARATOR ); 
* Jetzt Eintrag im "Windows"-Menü anhängen */ 
ilndex = GetNenultemCount( hmenuWindom ) - WINDOW_POS + 
GetWindonText( hwndChild, szCurrent, sizeof( szCurrent ) N, 
BpRIEF, szText, "dd. 45", ilndex, szCurrent ); 
Er su hmenuWindow, 
sites 


Ei Peak I ME K"BYPösITTOR | | “hr PP chkcxen } | ME_STRING ): 


HdiReinsertWindowInMenu( hwndCchild ) : void; 
hwndChild Bezug auf Dokument-Tochterfenster 
" füge den Titel eines verbo: Dokuments im *Fenster"-Henü wieder ein. 


* Der Index wird berechnet, indem die Anzahl der Einträge des Menüs 
2 u wird. 
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void MdiReinsertwindowInNenu( 
: HWND hmmndChild ) 


szCurrent[50)5 /* Text des Titels */ 

szTex Be ns /* Text für Henleintrag zZ. 

j /* numerischer Index für *Fenster"-Menü */ 
/* *Fenster*-Henü ” 
/* Bezug auf MDI-Hauptfenster */ 


GetProp( hundkain, PROP_WINDOWHEN) ): 
falls erforderlich ich Separator-Tinie ein */ 
‚tMenultemCount( hmenuWindow ) == WINDOW_POS - 1 ) 


N aa heenuWindow, 
ML, 
MF_APPEND | NF_SEPARATOR ); 


Jetzt Eintrag im "Windows"-Menü anhängen */ 
ilndex = GetMenultemCount( hmenuWindow ) - WINDOW_POS + 1; 
GetWindomText( hwndChild, eo sizeof( szCurrent )); 
sacurrent[sizeofl szCurrent ae 
Be szText, "Btd. 45", 1ndl, szCurrent ); 
am Ende an */ 
Chan u( hmenukindow, 


szText, 


Ge hwndChild, 
Fa I Mr CHECKED Ehe E srrıke Js 


WR Änderu “ 
RC, karl hunfaain ); 


MdiRemovekindowFromkenu( hwndChild, bHindomDying ) : void 


hwndChild va auf Dokument-Tochterfenster 
bWindowdying ist TRUE wenn das Fenster zerstört wird. 


* Entferne den Titel eines Dokuments aus dem "Fenster”-Menü, wenn das 

* Dokument verborgen oder zerstört wird. Wenn der Dokument-Titel nicht 
* der letzte Eintrag im Menü ist, werden die folgenden Dokument-Indizes 
KTERTTIEE: 


void MdiRemovewindowFromllenu( 
HWND hwndChild 
bwindomDying ) 


szCurrent (50);  /? Text des Titels */ 

szText [50]; /* Text für Menüeintrag */ 

ilndex; /* nuwerischer Index für "Fenster*-Henü */ 
menachi1d; /* Die Menüleiste dieses Dokuments */ 
hmenuWindow /* *Fenster"-Menü * 

hwndMain; /* Bezug auf MDI-Hauptfenster */ 


{ 


/* Ermittele wichtige Daten Na 
hwndMain = GetParent( hwndChil 
hmenuchild = GetProp Nundchi1d, DEpop CHLLONENU ); 
hmenuWindow = {‚humdain, PROP_WINDOWENU J: 
/* Berechne Be Index Be 
for Al ilndex = WINDOW_PO 

ilndex < Gethaneftäntoint( hmenuWindom ); 
ilndex++ ) 


if ( GetMenultemID( hmenuWindow, index } 
= GetProp( hild, PROP MENJID ) 
{ a; aa wurde gefunden *7 


, Entferne Eintrag im Menü */ 


[4 7 hmenuWindow, 
Br hundchild, PROP_MENIID ). 


I MF_DELETE ); 
iere den Rest des Menüs 
ultemCount( ad ) == WINDOW_POS ) 
Ertlerae BE ate *“/ 
u( hmenuWindow, 
WINDOW_POS - 1, 
MWLL, 


ME DELETE | MF_BYPOSITION ); 
ri je Verschiebe nachfolgenden Menüeinträge nach oben */ 
for ( ; ilndex < GetMenultemCount( hmenukindow ); ilndex++ ) 
GetMenuString( hmenukindow, 
ilndex, 
szcurrint, 
izeof( szCurrent ), 
ft; BYPOSITION ); 
sprintf( szText, 
"Bud. 45", 


ilndex - WINDOW. POS + 
strehr( szCurrent, ' ' 1 +1); 
ul hmenuWindow, 


ilndex, 


szText, 
GetMenultemID( hmenuWindow, ilndex k 
MF_BYPOSITION | MF_CHANGE | MF_STRING | MF_UNCHECKED ); 
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“ 
£ MdiWindowilenu( hundMain, mwenuchild, bAttach ) : void 
f 
Bezug auf MDI- Dimmer kndlalste 


N 
Hr Aktuelle 
bAttach füge ein oder ent 


in 
hmenuchi ld, 
bAttach ) 


hmenuWindow; /* Bezug auf *Fenster"-Menü */ 

= GetProp( hwndMain, PROP_WINDOWHENU ); 

rg bAttach ) { E " 

Füge hi 

a. üge mu Äh. 
"Äfenster*, 
hmenuki D 

SE MTOR | MF_BYPOSITION | MF_POPUP ); 


case FALSE: 
/*® Entfi Menü */ 
Cha 


haenuchi 
GetMenu rg Nenuchitd )-1ı 
LPSTR ) WILL, 


ME_BYPOSITION | MF_REMOVE ); 
break; 
) return; 
2 
® = HdilnitSystemenu( hwndchild ) : void 
: hundchild Bezug auf Dokument-Tochterfenster 


* Stelle sicher, "daß das gg ae se ion tevermenü korrekt is Ei 
"Dies vo t kein Thema m ochterfenster ein Vollbild ist, da 


wurde. s Stevermenü ke 
* Toch terfansters | Befindet, ist es ie Standard-Fenster-Steversenü und 
ar die <Alt>-Abkürzungstasten anstatt den «Strg>-Abkürzungstasten. 
'oid MilnitSystemllenu 
“OT uND Keentla ) 


| HMEW) hmenusystem; /* Bezug auf Steuermenü */ 


* ion eine Kopie des Steuermenüs */ 
uSystem = ve Hasen e7 hwndchild, FALSE ); 
PR Ini iaielere $ 
ange uSystem 
"Hi ern, 
irren GetParent Bee „_PROP zn) 


: MFTBYCOMMAND | WE BEE wu); 
ns 


Bengen\tsirger”, 
Weah | me I MF_STRING ); 


si 
Indera\tserger®®. 


MF_CHANGE | MF_STRING ); 
Iran | 0 CM 1 


El Ibi bildlisergoFio" R 
WERTCOMARG | Mr CHE | MF.STRING ); 


hmenusystem, 


seh chleßen\tstrgpra". 


ME-BYCORMAND | IF_CNANGE | NFLSTRING ; 


r £ MißetchildSysenu() : 


:r das Steuermenü für ein Dokument. Das Menü wird nur dann ver- 

" wendet, wenn das Dokument A; "yonlbiid dargestellt ist. Andernfalls 
® wird das Standard-Steuermenö verwendet t, dessen Text beim Erhalt der 
PA INITMENU-Kachricht modifiziert wird. 


vo MdiGetChildSysMenu( void ) 
HMENU haenuSystem; I" Bezug auf Stewermenü */ 


Listing 4: (Fortsetzung) 
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das Menü */ 


Rn erg ) 
Beta, 
10m 


MF_ÄPPEND | "NF_STRING 
n ( hmenußystes tem, Fi 
Rn \tStrg+F7*, 
nee 


Ben man KoPEm | az 


MF_SEPARATOR ): 
"| MFLSTRING ): 
tem; 


Ir 
S MdiCrenteCchildSysBitmap( humdMain ) : HBITMAP; 
: hundMain Handle to MDI desktop 


ein Rasterbild für das Stevermenü eines Dokuments. Das Raster- 
It einem Kinuszeichen. Es wird vom Windows-System zur Verfü- 


"gu angelegt werden . Das System-Bild 

bu besteht i $ n! likationsfenster 

* (Hauptfenster) und eine linke für N ge 'enster. Diese Funktion 

hr erzasgt eine, Speicher-Zeichenbereich für das a hend und einen 

* weiteren Pi eineren) für die nagelneuer wird mit 

"Bi u, ie Tochterfensterhälfte in den zweiten Bereich en und 
„ Sieser als Rasterbild zurückgegeben. 


mie aa = tmap( 


/* Haben wir ein „setiue Rasterbild? */ 
/* Zeichenbereich I-Hauptfenster */ 
I there Ent chenberuich für beide Bilder */ 
/* Speicher-Zeichenber. Tochterfenst.-Bild */ 
/* Rasterbild-Parameter 7 
/* Bezug auf Rasterbild der beiden Bilder */ 
un; .- en des Tochterfenst.-Bilds */ 
iBitmapkidth; /* Brei em-Rasterbilds */ 
iöitmapheight; /" höhe a Sys efastersiies -“/ 


i IRCE( OBM_C ; 
W | bien = Togpiempt WILL, MAKEINTRESOURCE ( Lose ) ); 


A K.h a ung Be Bitmap )» ( LPSTR ) &Bitmap ); 
e - ats SR SH_CYNEW ); 
Y { Ko ni 


loc = ibl H 
ne omat bledc( ADC ): 


Mn 


eDC( hoc ) 


Fr en et Bine) ): 


if ( hiemilal fc 
Mal fBitmep - en hilemHal fDC, 
, 
if hie 


Selectübjec Ip hHalfBitmap ); 
mu IfbC, 


Hbitin itmpkidth, iBitmapkeight, 

bResult . Biehiec hMemHal fDC, 
ißitmapkidth, iBitmapkeight, 
hMemFul | Pi 


Bitaepdi, 0, 
burerascı hieshalfdc ); 
leteDCl( hMemfulloc ); 

koressesc IumdMein, hOC ); 
leteöbject( hFullBitmap ); 
return bResult ? hHalfBitmap : MWLL; 


SetMenuKeyhook( hinst 
e” ie t an Ar, arte Instanz 


* Installiere den taskorientierten Syetuneeo) chran-? stemeingriff zur 
* Überwachung der Tastatur-Eingänge. Damit ist es möglich, bestimmten Tasten 
u a zuzuweisen. 


Listing 4: (Fortsetzung) 
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id MdiSetllen: Hook 
S HANDLE “le „ 


" TEL S Stulpen 


ind 
® 2 Hdilenullessageloopüpdate( hundMain ) : void; 
: hundMain Bezug auf MDI-Hauptfenster 


" Aktiviere das richtige (Aufklapp-) Menü, wenn die linke oder rechte 
et » Richtungstaste rückt wurde und das Steuermenüs il Dokuments 
vorha! ist. 3 sie ware erfol nachdem 
* die Funl 81 Dispake ee Hr wird erreicht, 
” An eg rg blicklicl surgelap te Wenö ln wird, 
das mächs hste aufgeklappt 


void MdiMenules te( 
f HWND bundlain 


int t0ldNext; /" rette a licklicher Status */ 
HNO hundActive; /* Bezug auf aktives Dokument-Fenster */ 


ner ohne ee ist wit Sicherheit kein Menü aufgeklappt */ 
POP_NONE; 
a Rup = POP MÖNE ) 
hd sims Sequenz ist nötig, weil der SendMessage()-Aufruf reentrant- 
Probleme erzeugen . “ 
joamsı = iNext 


NextPopup = POP._| 
» Lrt hrage au korrekte Nenä hi 
hundActi Prop( hundhain, PROP_ACTIVE ); 
switch( Toranent ) 


break; 
case POP MAINIST: 
/* wechsele zum ersten Menü in der Menüleiste ("Datei") */ 


selon, . 
(DORO) w); 


SPOP cHLLosr 
mr Bondketive ) 


Mdilsgliook( iContext, wCode, IParam ) : LONG: 


iContext das Ziel der System-Nachricht (z.B. Menü) 
ode un t 


tz 
Zeiger auf die eingegangene Nachricht 


m FAR PASCAL AL Winplookl 
Lu) 
WORD ee 
.. !Param ) 
BOOL bCancelMenu = FALSE; 
BOOL bActive; 
BOOL bZoomed; 
HWND hwndMain; 
NSG 


we “his: 


(88 ER 5 ) IParan; 
wein bundhain, PROP_ISKOI ) ) 


GetParent( hundMain ); 


len 11 es SH RıchT ) 


gr ke oder rechte Richtungstaste im Menü */ 
tch( iCurrentPopup ) 


Listing 4: (Fortsetzung) 
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San 20 Bee VK_LEFT ? POP_MAINSYS : POP_MAINIST ); 
bCancel - we a Ken ; 
POP MnsıS 

case H 
# ( Key == VKLRIGHT ) 

iNen‘ = POP _CHILDSYS; 
Ne = TRUE; 
k; 
INIST: 
.- VK_LEFT ) 
{ = POP_CHILDSYS; 
Deincelhehu = TRUE; 


Menu ) 
IpMsg->wParam = VK_CANCEL; 
" Ende des Systemeingriffs */ 
return De { teontext, 


V"FRRPÄOC FAR = ) AlpO1dsohook ); 


Fand 

x NdifreeienuKeyhook( void ) : void 

* Gibt die Prozedurinstanz frei, die für den Menü-Systemeingriff 
ne wurde. 

void MdifreelenuKeylook( void ) 


} FreeProcinstance( IpisgHook ): 


Listing 4: (Ende) 


für ilieren 
era AM =-c -Osa] -W2 -Zp 


Kullob wdil.c mdi.h 


ER IREE 


wdi2.obj: mdi2.c mdi.h 
el SICFLAGS) mdi2.c 


=di3.obj: mdi3.c mdi.h 
el STCFLASS) wdi3.c 


=di.lib: mdil.obj mdi2. 0 Rang 
lib mdi-Imdi I-mdi2-mdi3; 
del mdi.bak 


Listing 5: Die MAKE-Datei MDI zum Erzeugen der MDI- 
Bibliothek MDI.LIB 


# Flags für ilieren 
CH AM -c -Gsw -Osal -W2 -Zp 


4 COLORS 
colors.res: colors.rc colors.ico colors.h mdi.h 
re -r colors.rc 


colors.obj: Beure;e eolors.h adi.h 
el S(ChLa6s) colors.c 


colors,exe: colors.obj colors.def ndi.lib 
link4 colors,colors/ALIGN: 16,colors ‚mdi+ml ibwrnl ibcew/NOE,colors 
re colors.res 


colors,exe: colors.res 
re colors.res 


Listing 6: Die MAKE-Datei COLORS zum Erzeugen der 
MDI-Beispielapplikation 
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Windows 


COLORS 
"Mehrfach-Dokumenten-Schnittstelle' 
"WINSTUB.EXE* 


MOVEABLE DISCARDABLE PURE LOADONCALL SHARED 
MOVEABLE MULTIPLE 


Mdins: 85 
WalDIgunhde % 


Listing T: Die Linker-Definitionsdatei COLORS.DEF 


I" 
% COLORS.RC - Ressourcen-Datei für Applikation COLORS 
" Programmiersprache: Rierenft- c 5.1 

* Speichernodel]: 


i% Entwicklungsumgebung: Merosoft Windows 2.1 SOK 
® Status: einsatzfähig 


* Entwicklelt von: 
Geoffrey Kicholls 
Kevin P. Welch 


MR: right 198 1908 


”989 E, Hisaen Siyd Suite 260 
Ir „ Foster City CA 14404 


! Deutsch Anpassungen: Marcellus Buchheit 


Fi 

f Spezifikation der Kopfdateien für COLORS 
#include <WINDONS.H> 

Hinclude "COLORS.H” 

Hinclude "WDI.K" 


Mainlcon ICON colors.ica 


OM"SAVE, GRAYED 
Ior CSAVEAS, GRAYED 


10M_EXIT 
LOMZABOUT 


10M_NEW 
I HPER, GRAYED 
CLOSE 


Ion SAVE, GRAYED 
100” SAVEAS, GRAYEO 


10OM_EXIT 
10WABOUT 


10_0 
10m" 25 
m 


10775 
1047100, CHECKED 


10M_NEW 
IOM_OPEN, GRAYED 
DMCLOSE 
DMSÄVE: GRAYED 


1 
.", IOMTSAVEÄS, GRAYED 
MENUITEM 


Listing 8: Die Kopfdatei COLORS.RC der MDI-Beispiel- 


applikation 
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NENUITEM "ABeanden* 
NENJITEN "Büber COLORS... 


IONCSAVE. GRArED 
IOM-SAVEÄS, GRA 


IOM_EXIT 
TOMLABOUT 


1040 
104725 
MENILTEN “8 ON A 


104775 
HENIITEM "8100 IDM_100, CHECKED 


END 
BlueAccel 
BEGIN 


"Wehrfach-Dokument-Schnittstelle (MDI)* 
*"MdiMainllass” 
"Wdichildllass" 


IDCANCEL, 108, 28, 
DIALOG 22, 17, 156, 100 
;_DLGFRAME |S_Popub 


ten-Schnittstelle*, 
cholls*, 


4» 09 00 0m 00 00 00 


5 
& 


10M_NEWWINDOW, GRAYED 
IOM_ARRANGE, GRAYED 
IOMTARRANGEÄLL, GRAYED 
I0M_HIDE, GRAYED 
u TOMTUNKIDE 
Be eos ACCELERATORS 
10M_CLOSE VIRTKEY, NOINVI 


IB 


IOMCHONE 
ION SIZE, 
IOMMAXIMIZE, VIRTKEY, 


miunhide DIALOG 2 so, 150, 68 
sine S_DL us Ppoplp 


.10 
48, WS_TABSTOP 
ri 


END 


Listing 8: COLORS.RC (Ende) 
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Windows 


rl #Hinclude <STRING.H> 
* » COLORS.H - Kopfdatei für Applikation COLORS #include <STDI0.H> 
#include <WINDOWS.H> 
x Programmiers che: Nicrosoft-C 5.1 

ichermodell: medium #include "COLORS.H* 
x vDrteleklengeunnihängi Nicrosoft Windows 2.1 SDK #include "NDI.H* 
8 * Status: einsatzfähig r 
* Entwicklelt von: * Statische Variablen 
* Geoffrey Nicholls % 
* Kevin P. Welch u 
hd /* Text für Fenster-Abbildungsbereich */ 
a . static char en {0 4", "25 4%, "50%", "75 8%, "100 8"); 


* 989 E Hiisdale | Sins, Suite 260 /* Titel der Dokumente 
id ame City CA static er eettesß] = { "Rot*, "Grün", "Blau" ); 


/* Zähler der einzelnen Dokumente er die Titel) */ 
“ static int wounts[3] = { 0, 0,0); 


* Ressourcen-Datei-Konstanten 
". /* Farben- und Graustufen-Tabelle */ 
static DWORD nyheslersiä (5 } -{ 


/* Zeichenketten */ 
TLE EIER 


RGB(255,192,192), 
define 10S_COLORCLASS 3 RGB(255,128,128), 


PR für ER “ R6B(255,0,0) 
'* GREEN */ 


RR; 
r A im Menü "Datei* */ 255,255,255), 
0x101 RGB(192,255,192), 


0x102 RGB(128.255,128). 
0x103 RGB( 64,255, 
0x104 RGB(0,255,0) 

0x105 


#define TOM 0x106 € 18 tue “ 
#define IOWEXIT 0x107 55,25 il: 


„... 
= 


J 
25 
50 
75 
00 


ss“ 


1 


nn 

Ss8Io 
..—.. 
„an .» 
nn 


_ 


De Einträ im Menü Farbe Kalle. ie. = 
ntr " "Farben" 
9 02109 FRERTE 


Idefine IonC25 9x109 02a) 


Ox10b 
idefine IOM7100 Ox10c 


Lee im N a u 4 PASCAL WinMain( hPrevinst, hinst, IpszCommand, nCmdShow ) : int: 
ine D 
Idefine DLGNEW GREEN 0x10 hPrevinst Bezug auf vorherige Instanz 


#define DIENEN BLUE 912 Bezug auf aktuelle Instanz 
j Zeiger auf die A er Befehlszeile 


I" Show Parameter für Showkindow 
graue Fenster-Konstanten 


in 
SI 
u... 
„nn 
en en 


_ 


Dies ist die erste Funktion, welche das Systems aufruft 
Sie ruft die Initialisierung auf und enthält die Kachrichtenschleife. 
4define WE_COLOR } 1) 
#define WE_SHADE 2 
tdefine WE_EXTRA 4 int PASCAL Winkain( 
HANDLE 
0 
1 
2 


hinst 
Adefine COLOR_RED HANDLE Previnst, 
define COLOR_GREEN LPSTR re 


Adefine COLOR_BLUE 


I" hwndColors; /* Bezug auf u ”/ 
a au der Funktionen wg; /* Aktuelle Nachricht */ 


/* Initialisiere alles, was die Applikation verwendet */ 
int PASCAL pre HANDLE, HANDLE, LPSTR ‚int 35 hwndColors = MainInit( hPrevinst, hinst, nCmdShow ); 
Maininit( HANDLE, HANDLE, int if ( !hwndColors ) 


/* Fehler beim Initialisieren */ 
return NULL; 


h Verarbeite Nachrichten "/ 
while ( MdiGetMessage( hwndColors, Bmsg, WLL, WLL, WLL ) ) 


| /* Standard-) Haneheichtan-Vererbaltung.t/ 
if ( tMdiTranslateAccelerators( hwndColors, Bmsg ) ) 


TranslateMessage( Bnsg ); 
Listing 9: COLORS.H, Kopfdatei des MDI-Beispiels N Dispatchlessagel Au); 


h Applikation beendet */ 
return msg.wParam; 


I* 
: COLORS.C - Farbige MDI-Tochterfenster 


i rammiersprache: Microsoft-C 5.1 

. Fr Kor A pi ft Windows 2.1 SDK 
‚ntwicklungs: : Microsoft Windows 

" Status: 2 si einsatzfähig 


Ir 
2 Maininit( hPrevinst, hInst, nCmdShow ) : HWND; 


hPrevinst Bezug auf vorherige Instanz 
hinst Bezug auf aktuelle Instanz 
Parameter für Showtindom() 


Zunächst wird die Ml-Oberfläche und die Farben-Dokument fenster 
initialisiert. Anschließend wird die MDI-Oberfläche erzeugt und ein 
ie Dokumentfenster angelegt. 


” * Dieses Hodul enthält den gesamten applikationsspezifischen Code für die 
likation COLORS. Diese besitzt eine MDI-Oberfläche in der sich eine 


« x iebige Anzahl von farbigen "Dokumenten" befinden kann. Diese sind 
entweder rot, kn oder blau und können in 25%-Schritten mit Grauwerten 


ei Ben 0 bis 100%) versehen werden. Um die Technik der Abkürzungstasten 
" zu demonstrieren besitzt nur ein Fenster mit einem "blauen Dokument" 
> Abkürzungstasten. 


2 Entwickelt von: Geoffrey Nicholls, Kevin P. Welch 


a N ps 1988 Eikon Systems, Inc 
Ind Iisdale Bivd, Suite 260, fekter City CA 94404 


ai matelntet 
JANDLE hPrevInst, 
HANDLE Inst, 


szTitle al: /" Titel des MDI-Hauptfensters */ 

sechs [DR 1-Hauptfensters */ 
hwndColors; /" Bezug des MDI-Hauptfensters */ 

WndClass; /* Struktur der Fensterklasse */ 


Listing 10: COLORS.C: Beispiel einer MDI-Applikation Listing 10: (Fortsetzung) 
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Windows 


pl repsse Fenatarklassen a 4 case WM_DESTROY: 
if "ihprevins t) ee 0); 


terklassenname des Hauptfensters likationsfenster) */ 
gr ver er ) return MdilaindefWindowProc| IwmdColors, message, wParam, IParam ); 


hinst, 1051 HAINCLASS, s2Class, sizeofl szClass 
istrierungs: 
lass, 0, sizeof( "ndelass Is) nenn 
pie = CS _HREDRAW | 
nMndProc - Keiner 
= hinst 
- LoadIcon( hinst, *"Mainlcon* ); 
= LoadCursor' { 


NL "ey A H 


. 
NREDRAM ; 


Colorinit( hinst ) : BOOL; 
hinst Bezug auf Instanz der Applikation 
% Registriere die Fensterklasse der Tochterfenster (Dokumente) 


Bo0L Kgglgrimiet 


( char szClass [80]; /" Name der Fensterklasse */ 
WNOCLASS  WndClass; /* Struktur der Fensterklasse */ 


/* lese Fensterklassen-Namen ein "/ 
ser ( hinst, ios EOLORCLASS, szClass, sizeof( szClass ) ): 


strierungswerte *, 
wonset lass, 0, sizastt Badca WndClass | slinen 
WndClass.style et 


hinst ) 


PH elechjerfunster hat seine eigene Initialisi ” 
ir 5 Ieteriettüinst) ) 
return 


” {jope mat Mask IB TıfE likationsfenster) 
reg hinst, 1DS_TI a ee sizeof Hrikte )) 


“tel, ws traten 
SCUSEBEHAULT, {27 Ou Usterkutn. CH_USEDEFAULT, CH_USEDEFAULT, 


Bi 


/* registriere 


LL 
wurde e gs Igreich legt? */ 7 
2% ie — return Registercl ass( SiindClass ); 


Tochterfenster */ 
(4 Wiesfererunte hwndColors, COLOR_RED ) ) 


DestroyWindom( hundColors ); 
He ‘ h 


) 


” 
% ColorCreate( hwndParent, „Type ) : HWND 


hwndParent Bezug auf das MDI-Hauptfenster 
„Type Farbe des Dokuments 

* fertig: zeige alles an */ 
Show i ndom ors, nCndShow ); 
u en ndow „nendtolors hi 
‚ckkehr 


return Konica ors; essen 
des Dokuments Tnitialisiert, 


MMNO ColorCreate( 
AWO 
«Type ) 


Ir 
2 MainindProc( hundkain, message, "Param, IParam ) : LONG 
2 Bezug des u 
? WORD-Parameter der Nachricht 
“ 


Era /* Klassenname für Dokument */ 
szTlitie SER pm Titel für dieses eg or 4 
’ nur u” 
” ee Nikations-Instanz ”/ 
% Bezug auf die Menüleiste des ER u 
/* Bezug auf Fenster des Dokuments */ 


LONG-Parameter der Nachricht 


* znerbalte Bachrichtes an das MDI-Hauptfenster. Dies beinhaltet auch 
alle WM_COMMAND-Nachr‘ ee die übergeben werden, wenn KEIN Dokument im 
: Ruptfenster abgebildet i 


1 FAR PASCAL Mai ehnderoe el, Kt y, 
u = ( wype] ): 
WORD” zu. 
LONG IParam ) 


FARPROC 1 N /* Prozedur-Instanz für Dialogfelder */ 
WANDLE hinst; /" Bezug auf Instanz der Applikation */ 


er 


case COLOR RED: 
BRENW» = Losdienu( hinst, "Redkenu* ); 


ER hmenschild se = Loadiienu( hinst, "Greenlenu® ); 


BLUE: 
u d = Loadlenu( hinst, “Bluelenu” 
WM_COMMAND: hAccel = LoadAccelerators( hinst, Plosrehiı- ); 
mt, i Ti bundColors, GWW_HINSTANCE )i break; 

Param 
ie Fenster an */ 

case IDM_NEW: ild = ee szClass, 
” vielagiehd Maut */ 
pProc = MakeProcInstance[ NainD1gNew, hinst ); 
switch( DialogBox( hinst, "Mainhew", hwndColors, IpProc ) ) 


case DLGNEW_REI 
De "mndColors, COLOR_REO ); 


case DL 
Gelorereite N ssiss; COLOR_GREEN ); 


Parent, 
fm 
hinst, 

ol 


War er erfolgreich? */ 
{ bImndchild ' 


ndoword yaiill, WE_SHADE, I0M_100 )i 


case 
Serwindenkord COLOR, wi 
, Miseiheei ee Niype Dt 


„a DLOkeu_ BLUE 
Golerereiel hundColors, COLOR BLUE ); 


Irproctestnet IpProc ):; 
case I0M_OPEN: 


return Indchild; 


I" 
x ColorWndProc( hmndColor, message, wParam, IParam ) : LONG: 
Bezug des MOl-Hauptfensters 
. Nachricht 


ch 
WORD-Parameter der Nachricht 
LONG-Parameter der Nachricht 


” » verarbeite Nachrichten an eines der Dokument-Tochterfenster. Die 
WM_COMMAND-Nachrichten der z ee und angezeigten Menüleiste werden 
2 antlts an diese Funktion 


ase 
Ipre: ‚Dälegteie "06 "Ober" * 
ne hkataheei MainDigAbout, hinst ); 
ofafesen hinst, "MainAbout”, hwndlolors, IpProc ); 
reeProcinstancel IpProc ); 


case I0M 
je AD: EM Schließen-Befehl weiter */ 
Leetinenage| hwndColors, WM_SYSCOMMAND, SC_CLOSE, OL ); 
reak; 


Listing 10: (Fortsetzung) Listing 10: (Fortsetzung) 


32 Microsoft System Journal Juli/August 1989 


long FAR PASCAL ColoriindProc( 


a bundChild, 
u x 


LONG 1Param ) 

char szText m Abbil bereich *, 
20): reich */ 

PALNTSTINGT Raintı, 


case Tom CLOSE: 
Posthnsagel hwndChild, WM_SYSCOMMAND, SC_CLOSE, 1Param ); 


Grein eiten( Mitarheref - ei 


Checks een bundchi1d.) 
ereltal 


InvalfdateRect Findchitd, (uneer) ii TRUE ); 
break; 


” Sender bundChild, WE_COLOR 
Beer ee WE_SHADE 
Lese  äßruch r Ursbläters Eoagrese - 1M_0] ); 


[li Rect, KR Da apat Beet rePaint, hörus 


ER ei. rk PR RER )) 
} Pair MdiChildDefWindowProc( hwndChild, message, wParam, IParam ); 


/* 
5 MainDigNew( hDlg, message, wParam, IParam ) : int; 


kam Bde Biatofeld- Fenster 
WORD "Parameter Aachricht 
LONG-Parameter der Nachricht 


verabeite Nachrichten vom Dialogfeld des Befehls "Neu" 


int FAR PASCAL MeinD] 
HNO hölg, au 


Listing 10: (Fortsetzung) 


Sagen Sie Fingerspitzen- 
heute nicht mehr 
aus, wenn man 
perfekte Qualität 
in der Program- 
mierung liefern 
will. 
PEM bietet Ihnen 
jetzt innovative, 
praxisnahe Tools 


Neue Tips 


und neue Tools an, deren sofortiger 


für System-Entwickler. Nutzen begeistert. 
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[HEHE Due 


gefühl allein reicht 


MagicCV, Reg. Trademark Nu-Mega Techn. CodeView, 
MS-Windows. Reg. Trademark Microsoft, 


iButton re Position der runden Optionsfelder */ 
Ihe‘ = FALSE; /" Rückgabewert */ 


switch ( message ) 


WM_INITDIALOG 
Me endfassage hbig, WM_COMMAND, DLGNEW_RED, OL ); 
ee 


WM_ COMMAND: 
"witchl Waras ) 
case DLGNEW_RED: 
se “en 
Be ho} 
f"{ NIVORD( IParam 0. en N DOOBLEELICKED 


SendMessage( hDlg, WA_COMMAND, 1D0K, OL A 


a“ 


nel { hölg, iButton ) 
‘ . on )i 
break; . s 


TED T BLUE, iButton ); 


case IDCANCEL: 
EndDialog( hölg, © ); 
break; 


) 
return iReturn; 


MainDigAbout( hölg, message, waram, |Param ) : int; 
Bezug auf Dialogfeld-Fenster 
übergebene Nachricht 
WORD-Parameter der Nachricht 
LONG-Parameter der Nachricht 


tn Nachrichten vom Dialogfeld des Befehls "Über COLORS" 


int. FAR PASCAL MainDIgAbout 
HNO holg, ( 


unsigned massage, 
LONG 
int iReturn = FALSE; /" Rückgabewert */ 
switch( message ) 
case Mm INETDIAGDR 
IRe‘ TRUE; 
In 
case WM COMMAND: 
EndDfalog( hülg, TRUE ); 
Br og hölg ) 


return iReturn; 


Listing 10: (Ende) 


Ankreuzen genügt — 
Informationen. Coupon au 
- Absender nicht ver« 


R 
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CD-ROM 


CD-ROM setzt sich nun auch in Deutschland durch: 


Das Gigabyte-Zeitalter 


Komplexe Fertigungssysteme, überregionale 
Reglementierungen und Verwaltungsverfahren 
machen Informationen in steigendem Maß zu 
einem Wirtschaftsfaktor. In USA ist man sich 
des enormen Wettbewerbsvorteils durch kom- 
primierte Datenbanken mehr bewußt als in 
Europa, weshalb dort die CD-ROM ein stark 
verbreitetes Speichermedium ist. 


Die CD-ROM wird, analog der CD im Audiobereich, vom 
Hersteller mit Software und Daten »beschrieben«. Sie ver- 
fügt über Datenkapazitäten, die da anfangen, wo andere 
Massenspeicher aufhören, nämlich ungefähr bei 550 Mbyte. 
Diese Kapazität entspricht annähernd 3 Mio. A4-Seiten 
Text oder 1000 Disketten. Der Nachteil: CD-ROMs können 
nur einmal beschrieben und dann nicht mehr verändert 
oder gelöscht werden. Der CD-ROM-Anwender benötigt 
einen IBM-kompatiblen PC mit mindestens 512 Kbyte 
Hauptspeicher einen Controller, um das CD-ROM-Lauf- 
werk anzuschließen. 

Die Produktion der CD-ROM läßt sich in zwei wesent- 
liche Abschnitte gliedern: die Informationsaufbereitung und 
der eigentliche Herstellungsprozeß der CD. Zur Festlegung 
des Datenbankdesigns setzt sich der Anbieter von Abfra- 
gesprachen (Retrievalsoftware) mit dem Kunden zusam- 
men. Im nächsten Schritt wird die zwischen Kunde und 
Hersteller vereinbarte Softwarelösung für die Datenbank 
geschaffen. Das künftige Datenbankdesign wird dann, ver- 
sehen mit Testdaten, auf Magnetspeichern simuliert. Erst 
nachdem sich die Datenbank auf diese Weise bewährt hat, 
wird sie zusammen mit den erforderlichen Daten auf CD 
gepreßt. 

Die Speicherung erfolgt bei optischen Laufwerken mit- 
tels Laser eingebrannter Informationen, sogenannter Pits. 
Gelesen werden diese Informationen berührungslos durch 
einen fokussierten Laserstrahl. Die hohe Aufzeichnungs- 
dichte hat einerseits den Vorteil, daß große Datenmengen 
auf einer Compact Disk untergebracht werden können. 
Andererseits ist die Datensicherheit um ein vielfaches höher 
als bei magnetischen Speichern, wo Head-Crashes den 
gesamten Datenbestand einer Festplatte vernichten können. 
Da die informationstragende Schicht einer CD in Kunststoff 
eingebettet liegt, ist sie bei weitem nicht so empfindlich 
gegen Schmutzpartikel wie magnetische Datenträger. 

Entgegen aller optimistischen Prognosen hat sich der 
CD-ROM-Markt in Deutschland bis heute noch nicht in 
dem Maß entwickelt, wie beispielsweise in USA oder in Ita- 
lien. Der Hauptgrund ist sicher, daß hierzulande kaum 
attraktive CD-Titel im Handel sind. Mehr als die Hälfte der 
deutschen CD-Titel sind Nachschlagewerke, die auch in 
gedruckten Versionen vorliegen. Geht es um die verkauften 
Stückzahlen, so sind die Werte für die Anbieter enttäu- 
schend: Haben Buchversionen, beispielsweise von Adreß- 
buchverlegern, Auflagen zwischen 20.000 und 30.000 Stück, 
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Die optischen Speichermedien CD-ROM und WORM im 
Größenvergleich. 


erreichen die CD-Publikationen oftmals nicht einmal eine 
Auflage von 1.000. Da es noch keinen richtigen Markt für 
CD-ROM-Anwendungen gibt, haben sich auch die Preise 
noch nicht stabilisiert. Ein Teufelskreis: teilweise recht 
teure Anwendungen verhindern den Absatz, den die Ent- 
wickler brauchen, um mehr und somit billigere Anwendun- 
gen auf den Markt bringen zu können. 

Deutsche CD-Software-Entwickler konzentrieren sich 
nach den Erfahrungen der letzten Jahre auf »geschlossene 
Benutzergruppen, zum Beispiel Informationsanbieter in der 
Industrie, die ihrer Vertriebs- und Service-Organisation 
umfangreiche Informationen zur Verfügung stellen müs- 
sen«, so Manfred P.Wendt von der eps GmbH (Tochter- 
unternehmen der Bertelsmann-Gruppe). Der Trend wird 
also dahin gehen, daß im Unternehmen bereits vorhandene 
Daten aufbereitet und auf CD-ROM in größerem Rahmen 
im Unternehmen genutzt werden. Verstärkt wird diese 
Tendenz dadurch, daß inzwischen schr gute Retrieval-Soft- 
ware angeboten wird und Spezialanwendungen für Unter- 
nehmen deshalb nicht mehr so teuer sind. 

Neben den unternehmensspezifischen Anwendungen 
werden in Deutschland hauptsächlich die CD-Produkte 
großer Verlage genutzt, die hierzulande die Hauptanbieter 
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von CD-ROMs sind. Als 1986 in USA erstmalig »Grolier’s 
Encyclopedia« auf CD-ROM erschien, wurde begeistert von 
einem neuen Zeitalter der Lexikographie gesprochen und 
Grolier machte in kürzester Zeit einen unerwartet hohen 
Umsatz. In Deutschland werden hauptsächlich Datensamm- 
lungen aus dem Bereich der Wirtschaft, wie »Wer liefert 
was?«, »Handbuch der Großunternehmen« von Hoppen- 
stedt oder die internationale Bibliographie »International 
Books In Print« des Saur-Verlags angeboten. Es gibt aber 
auch eine juristische Bibliothek (»Juris«, C.H.Beck/ent- 
wickelt von Dataware 2000), die alle Entscheidungen und 
Aufsätze der »Neuen Juristischen Wochenzeitschrift« ent- 
hält, die in der Leitsatzkartei ab Heft 1/85 abgedruckt sind. 
Bei dieser CD-Anwendung spielt, ebenso wie beispielsweise 
bei dem »Gefahrengut«-Katalog auf CD, die Verknüpfungs- 
möglichkeit einzelner Felder die Hauptrolle. Das bedeutet, 
der Anwender kann innerhalb eines Arbeitsvorgangs auf 
mehrere Begriffe zugreifen und Daten in kurzer Zeit nach 
individuellen Gesichtspunkten selektieren. 

Diese Selektionsmöglichkeit will man jetzt auch in Mul- 
timedia-Anwendungen auf CD-ROM realisieren. Fachleute 
sehen in der Kombination von Texten, Tönen, Stand- und 
Bewegtbildern eine Chance, den CD-ROM-Markt zu einem 
enormen Wachstumsmarkt zu etablieren. In USA haben 
derartige Anwendungen bereits heute eine große Verbrei- 
tung im Schulungssektor. Entwicklungsansätze in diesem 
Bereich gibt es schon länger, zum Beispiel das ursprünglich 
am David-Sarnoff-Forschungszentrum in Princeton ent- 
wickelte »Digital Video Interactive« (DVI) oder das 
bekanntere »CD-Interactive« (CD-I), eine gemeinsame 
Entwicklung von Philips und Sony. Da man CD-I-Applika- 
tionen künftig auch mit CD-ROM-Laufwerken nutzen will, 
haben sich im letzten Jahr Philips, Sony und Microsoft auf 
die erweiterte CD-ROM Architektur »CD-ROM XA« (Ex- 
tended Architecture) geeinigt. 

Der offizielle Standard für das (logische) Aufzeich- 
nungsformat, die Directory-Struktur und die Schnittstellen 
auf CD-ROM wurde bereits zu Beginn der CD-ROM-Ent- 
wicklung von einer Gruppe von Softwarcherstellern und 
Hardwareproduzenten festgelegt. Diese Gruppe nennt sich 
nach ihrem Tagungsort »High Sierra Group«. Was die Con- 
troller-Schnittstelle angeht, verwenden fast alle Hersteller 
von CD-ROM-Laufwerken die SCSI-Schnittstelle, die sich 
allmählich auch im Bereich der Magnetspeicher durchsetzt. 
Neben der hohen Datentransferrate hat SCSI den Vorteil, 
daß man bis zu sieben zusätzliche Laufwerke an einen 
Controller anschließen kann. 

Trotz all dieser Standardisierungsbemühungen gibt es 
aber noch einige Inkompatibilitäten zu beklagen. Die eben 
erwähnte SCSI-Schnittstelle beispielsweise ist nicht bei allen 
Laufwerken identisch, so daß Übertragungsprobleme auf- 
tauchen können. Es kommt vor, daß sich die Treiber für 
einzelne CDs gegenseitig stören. Die Cartridges sind nicht 
genormt, so daß es hier Probleme beim Einlegen in das 
Laufwerk geben kann. 
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Im Laufwerksbereich gibt es nicht viele Anbieter in 
Deutschland. Den allergrößten Teil des Marktes beherr- 
schen Hitachi, Sony, Toshiba und Phillips. Die CD-ROM- 
Laufwerke gibt es in externen Versionen oder als 5,25-Zoll- 
Einbaugeräte in voller Bauhöhe. Die Preise liegen zwischen 
1500 Mark und 7000 Mark, wobei keine Korrelation zwi- 
schen dem Wert des Produktes und dessen Position inner- 
halb des Preisbereichs zu bestehen scheint. 

Die Preise für die CDs orientieren sich selbstverständ- 
lich an der Komplexität der Anwendung. Da aber die euro- 
päische Audio-CD-Industrie in der letzten Zeit teilweise 
unter Überkapazitäten leidet, ist anzunehmen, daß der auf- 
kommende Wettbewerb wahrscheinlich geringere Aufberei- 
tungs- und Pressungskosten für CD-ROMs zur Folge haben 
wird. 

Frischer Wind weht aber auch aus einer anderen Ecke: 
Einige Hersteller, wie Apple und Atari haben sich ent- 
schlossen, ihre PCs auf Wunsch mit CD-ROM-Laufwerk 
auszuliefern. Gerüchte aus Fachkreisen besagen, daß bis 
zum Herbst noch einige andere PC-Hersteller ihren Kun- 
den diese Möglichkeit bieten. Apple-Gründer Steven Jobs 
hat bereits im vergangenen Jahr auf der Herbst-Comdex in 
Las Vegas seine Eigenentwicklung, den NeXT-Computer, 
standardmäßig mit einem magneto-optischen Speicher aus- 
gestattet. 

Dominique Guignol 


Was gibt es auf CD-ROM? 


Bertelsmann 


» Die Bibel auf deutsch, englisch, etc. 

ı ABDA-Datenbank für Apotheken: 150.000 Arzneimittel, 
Hersteller, Preis 

® Liefern und Leisten - Das deutsche Branchen-Fern- 
sprechbuch 

s Silverdat - Das Datensystem für die Automobilwirtschaft 

» Gemeinschafts-CD-ROM/Orts- und Straßenverzeichnis 
der Deutschen Bundespost sowie Müllers Großes Deut- 
sches Ortsbuch 


Dataware 2000 
» Hoppenstedt Firmenreport - 430.000 Firmenprofile 


Microsoft Bookshelf 


World Almanac of Books and Facts 
Rogets II Electronic Thesaurus 
The American Heritage Dictionary 
The Chicago Manual of Style 
Bartletts Familiar Quotations 


NeXT 


» Websters Collegiate Dictionary 
» Websters Collegiate Thesaurus 
» Shakespeares gesammelte Werke 
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CDs von Microsoft: 


Bookshelf und Programmer’s Library 


n skull of an 
a öfther of the Bointe: Fig juneture er es sagittal and lambdoid or 
sagittal and coronal sutures. 


soft touch n. One who is easily persuaded or taken advantage of. 
ur peieee data, such as programs, routines, and 

symbolic ges, ial to the ‚Sgeration of computers. 2. Documents 
containing A on the operation and maintenance of computers 

soft water n. Water containing little or no dissolved salts of calcium or 
mepmasiun. esp. water containing less than 85.5 parts per million of 

cium carbonate. 
soft"wod n. 1. The wood of a coniferous tree. 2. A coniferous tree. 


1. -ies. Informal. 1. A weak or ra person, 2. A person 


diffi AB Birth or be stri 


-gi*er,- gi*est. 1. Saturated or sodden with moisture; soaked. 
BT a1. 3. Husid; sultry.[<dial. sog, to soak]-sog* 
adv. 


soft*y n. 
RL 


En 
ie) 
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Bild 1: Hier wurde im Wörterbuch von Bookshelf nach dem 
Wort »Software« gesucht. 


Microsoft ist schon seit den Anfängen der CD- 
ROM-Technologie ein Vorreiter auf diesem Ge- 
biet. Die Nachschlagewerk-CD Bookshelf war die 
erste CD-Anwendung, die auf breiter Basis einen 
Erfolg verbuchen konnte. Mit der Programmer’s 
Library bietet Microsoft seit vergangenem Jahr 
auch eine ausgezeichnete Daten- und Dokumen- 
tationssammlung für Programmierer an. 


Microsoft Bookshelf 


Microsoft Bookshelf versammelt auf einer einzigen CD eine 
ganze Reihe von wichtigen Handbüchern und Nachschlage- 
werken, die gezielt für den Bedarf von Journalisten, Schrift- 
stellern und Publizisten ausgewählt worden sind. 


= The American Heritage Dictionary, ein elektronisches 
Wörterbuch mit über 200.000 Einträgen (Bild I). 

m Roget’s II: Electronic Thesaurus, ein Synonymwörterbuch 
mit über 500.000 Synonymen. 

= The 1987 World Almanac and Book of Facts, Informa- 
tionen aus den Bereichen Politik, Medien und Sport. 

w Bartlett’s Familiar Qutations, eine Zitatensammlung mit 
über 22.500 klassischen und aktuellen Zitaten (Bild 2). 

= The Chicago Manual of Style, Schreibanleitung und Stil- 
führer für Schreibende. 

= Houghton Mifflin Spelling Verifier and Corrector, Recht- 
schreibprüfer. 

= Forms and Letters, eine umfangreiche Sammlung nützli- 
cher Formulare, Briefe und Gliederungen. 

= U.S. ZIP Code Directory, das Postleitzahlenverzeichnis 
für die USA. 

= Houghton Mifflin Usage Alert, Verwendunghinweise für 
Wörter. 

= Business Information Sources, eine umfassende Samm- 
lung von Informationen aus den Bereichen Geschäft, 
Wirtschaft, Management und Marketing. 
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Elting Elsore Horison 
1909- 


The MEISTER is no better than its program. 


From Knowhow to Nowhere. 


Cyril Morthcote Parkinson 
1909- 


Work nds so as to fill the time available for its letion. 
ac Cyrit Northeote Parki 
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Bild 2: In der Zitatensammlung von Bookshelf findet man 
auch interessante Aussagen über Computer. 


Bookshelf kann mit den meisten Anwendungsprogram- 
men verwendet werden, so ist es von vorneherein darauf 
ausgerichtet, mit 12 weitverbreiteten Textverarbeitungen 
(z.B Microsoft Word, PC-Write, DisplayWrite, WordStar 
usw.) und Programmen wie Microsoft Multiplan oder Lotus 
1-2-3 Daten auszutauschen. Man braucht nur den Cursor 
auf ein Wort zu positionieren, zu dem man nähere Informa- 
tionen benötigt, und auf Tastendruck werden diese Infor- 
mationen angezeigt. Die Informationen können dann in den 
Text kopiert werden. 

Für Programmierer dürfte Bookshelf weniger interes- 
sant sein, für diese Zielgruppe bietet Microsoft seine Pro- 
grammer’s Library an. 


Programmer’s Library 


Mit der Microsoft Programmer’s Library steht Entwicklern 
von PC-Software ein leistungsfähiges Nachschlagewerk zur 
Verfügung, das auf einer CD-ROM mehr als 20.000 Seiten 
Dokumentation und über 1.000 Beispielprogramme bereit- 
stellt. Die 48 Handbücher sowie andere technische Doku- 
mentationen der Programmer’s Library - gespeichert auf 
einer CD - beinhalten Informationen über die Betriebs- 
systeme und Programmiersprachen von Microsoft. Das 
Spektrum reicht dabei von relativ kurzen Hinweisen bis zu 
detaillierten Abhandlungen. Für die gesamte Text-Daten- 
bank gibt es ein Inhaltsverzeichnis und Querverweise, so 
daß das Auffinden und Verbinden von Informationen rela- 
tiv einfach ist. Die Texte lassen sich mit Hilfe eines Text- 
editors oder eines Textverarbeitungsprogramms vom An- 
wender aufrufen und direkt in Programme oder Dokumente 
hineinkopieren. Direkt werden die gängigsten Programm- 
Editoren sowie fünf Textverarbeitungsprogramme unter- 
stützt. Auch die Übernahme in Form von ASCII-Files ist 
möglich. 

Die CD-ROM-Disk enthält darüber hinaus eine Reihe 
von Informationen über Hardware, wie die Microsoft-Maus, 
CD-ROM-Laufwerke und Videokarten. 
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CD-ROM 


r 


Microsoft Pascal References ans 


C References 
ösf2 References 
ndows Referen 


was Sn hefaraazee 
NS-DOS References 
BASIC References 


erences 


erences 
Hardware References 


New Dise 


} 


To jllustrate how a dynamic-link Merssy 1 ‚BIS, here is a simple 
dynamic-link library source file named dyn! 


Hinciude zu Me 
int 


fer Bcn zehrin as cbLength) 
T N eblansik; 


USHORT u 
DosWrite 24 far‘ pehstring, cblength, &usßytes); 


since the MS 05/2 function DosWrit@ 13 called. Notice that t 
variable is declared and initialized to zero. This directs the 


As er MS 0$/2 programs, the os2.h A is included in Kir Ben 
inker not 


to load the ertO startup module, which is not needed with dynanic-link 
libraries. 


ao PITPTTIPFTTTITUITITLTITDLETTERTTEITTITTITE —TIRTEEITTTETTET TI = 


Bild 3: Das Auswahlmenü, aus dem heraus der Bereich 
gewählt werden kann, in dem man suchen will. 


Die Programmer’s Library läßt sich sowohl direkt als 
auch aus anderen Programmen aufrufen. Im Gegensatz zu 
speicherresidenten Programmen kann der Anwender das 
Programmer’s Library-Programm jedoch auf einfache 
Weise wieder aus dem Speicher löschen, um Platz für 
andere Programme oder Daten zu schaffen. 

Nutzen aus der Programmer’s Library können nicht nur 
Programmierer ziehen, sondern alle, die mit Software arbei- 
ten, z.B. Autoren technischer Beiträge oder Produkt-Sup- 
port-Spezialisten, die schnell auf Informationen zugreifen 
wollen, ohne umfangreiche Handbücher durchblättern zu 
müssen. Im einzelnen sind in der Programmer’s Library fol- 
gende Bücher und Handbücher enthalten: 


= The MS-DOS Encyclopedia 

= Die Handbücher aus dem Software Development Kit 
(SDK) für OS/2 

= Die Handbücher des Microsoft C-Compilers in der Ver- 
sion 5.1 

= Das Buch Proficient C von Augie Hansen 

= Die Handbücher des Microsoft Windows Development 

Kits in der Version 2.0 

Das Buch Programming Windows von Charles Petzold 

Die Handbücher des Microsoft Makroassemblers 5.1 

Das Buch Advanced MS-DOS von Ray Duncan 

Das Buch Programmer’s Guide to PC and PS/2 Video 

Systems von Richard Wilton 

= Die Handbücher von Microsoft Basic, Pascal und For- 
tran 

= Über 1000 Beispielprogramme für MS-DOS, MS 0S/2 
und Microsoft Windows. 


Das Inhaltsverzeichnis der Programmer’s Library ist in 
neun Kapitel gegliedert (Bild 3). Jeder Bereich umfaßt alle 
technischen Handbücher der jeweiligen Version des Be- 
triebssystems oder der Programmiersprache. Die Doku- 
mentation für Presentation Manager und LAN-Manager 
war für die erste Ausgabe noch nicht verfügbar, ist aber in 
der neuesten Version 1.1 enthalten (s. »Mitteilungen«). 
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Bild 4: Gesuchte Wörter werden auf dem Bildschirm (hier 
_acrtused) hervorgehoben. 


Kernpunkt der Microsoft Programmer’s Library ist eine 
hochentwickelte Suchfunktion (Bild 4). Der Anwender gibt 
nur verschiedene Suchbegriffe ein und spezifiziert die 
logischen Beziehungen zwischen ihnen. Dabei läßt sich vor- 
geben, ob eine Ausgabe erfolgen soll, wenn einige der 
Begriffe gefunden wurden, oder ob nur dann eine Ausgabe 
erfolgen soll, wenn alle Begriffe gefunden wurden, oder daß 
nur dann eine Ausgabe erfolgt, wenn die Suchfunktion auf 
eine exakt definierte Zeichenfolge gestoßen ist. Man kann 
aber die Suchfunktion auch so einsetzen, daß verschiedene 
Begriffe im selben Kapitel oder Absatz zu finden sind. 

Wenn die Programmer’s Library aus einem Texteditor 
oder einem Textverarbeitungsprogramm heraus angespro- 
chen wird, so erfolgt die Suche automatisch nach dem Be- 
griff, auf dem der Cursor gerade steht. Der Anwender 
braucht dazu lediglich die Eingabetaste zu drücken, um die 
Suchfunktion einzuschalten. Er hat wie bei einem Buch die 
Möglichkeit, im Inhaltsverzeichnis ebenso wie in den aufge- 
rufenen Texten zu »blättern«, um sich einen Überblick zu 
verschaffen. Damit der Suchaufwand und die Suchzeit in 
vernünftigen Grenzen bleiben, erfolgt die Suche immer in 
einem Teilbereich des gesamten Inhalts. Der Anwender hat 
jedoch die Möglichkeit, schnell zwischen den Teil-Inhalts- 
verzeichnissen und den Bereichen hin- und herzuschalten, 
indem er die dafür zur Verfügung stehenden Such- und 
Bibliothekskommandos benutzt. 

Die Kompatibilität der Programmer’s Library zu einer 
Vielzahl von Texteditoren und Textverarbeitungsprogram- 
men macht es möglich, daß Informationen in das Anwen- 
dungsprogramm übernommen werden. 

Ganz gleich, wieviele oder welche Programme Sie 
schreiben, die Programmer’s Library dürfte innerhalb 
kürzester Zeit zum wertvollsten Nachschlagewerk bei der 
Programmierung werden. Hier findet man so gut wie alles, 
was man zur Programmierung auf PCs benötigt. Darüber 
hinaus hat man den Vorteil daß man mit CDs benötigte 
Informationen wesentlich einfacher und gleichzeitig 
schneller finden kann, als in Büchern. 
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Vom Regen in die Sonne: Monitore unter OS/2 


In den letzten Ausgaben des Microsoft System 
Journals haben sich mehrere Artikel mit der 
Programmierung von speicherresidenten Pro- 
grammen unter MS-DOS und den dabei zu be- 
wältigenden Schwierigkeiten beschäftigt. Wir 
wollen mit diesem Beitrag einen Blick in die 
Betriebssystemzukunft werfen und Ihnen die 
Möglichkeit vorstellen, unter OS/2 TSR-ähn- 
liche Programme zu realisieren. 


Aus dem Leben eines MS-DOS-Anwenders sind sie nicht 
mehr wegzudenken: die zahlreichen speicherresidenten 
Programme, die auf Knopfdruck nützliche Utilities aktivie- 
ren und von trickreichen Programmierern unter Verwen- 
dung von teilweise nicht dokumentierten Betriebssystem- 
funktionen erstellt wurden. Die TSRs (TSR = terminate 
and stay resident) unter MS-DOS versuchen, dem Betriebs- 
system, das nicht als Multitasking-Umgebung entwickelt 
und konzipiert wurde, scheinbar Multitasking-Fähigkeiten 
abzugewinnen; scheinbar deshalb, weil während der Aktivi- 
täten des TSR-Programms die Anwendung, aus der heraus 
das speicherresidente Programm aktiviert wurde, unter- 
brochen wird. Ein zentrales Element dieser Programme 
bildet eine Routine, mit der die Tastatureingaben abgefan- 
gen werden, um zu überprüfen, ob mit der eingegebenen 
Taste die Pop-up-Utility aktiviert werden soll. Darüber hin- 
aus muß besonders sorgfältig die Verwendung von Inter- 
rupt-Aufrufen implementiert werden (beispielsweise um 
eine Datei anzulegen), da MS-DOS nicht reentrant ist, und 
somit die Betriebssystemfunktionen nicht von mehreren 
Programmen zeitgleich benutzt werden können. 

Das Zusammenspiel von mehreren, gleichzeitig gelade- 
nen TSR-Programmen endet oft in einer Tragödie, da man- 
che Pop-ups nicht mit bestimmten Anwenderprogrammen 
geladen werden können oder speicherresidente Programme 
untereinander inkompatibel sind, so daß sie nicht gemein- 
sam benutzt werden können. 

OS/2 hingegen wurde als Multitasking-Betriebssystem 
konzipiert und besitzt damit die Fähigkeit, mehrere Pro- 
zesse, die gleichzeitig ablaufen, zu steuern, zu unterstützen 
und zu kontrollieren. Dies macht die Programmierung von 
TSR-ähnlichen Applikationen erheblich einfacher. Der 
Software-Entwickler wird bei diesen Projekten außerdem 
durch gut dokumentierte Betriebssystemfunktionen und 
Schnittstellen zum OS/2-API (application program inter- 
face, Programmierschnittstelle) unterstützt, mit denen auch 
ohne die von Kaare Christian beschriebene Macho-Philoso- 
phie (vgl. Speicherresidente Programme in MS-C, in MSJ 
Nov./Dez. 1988, S. 14 ff.) gut funktionierende und koopera- 
tive Pop-up-Utilities erstellt werden können. 

Den Gerätemonitoren, einem Mechanismus, mit dem 
unter OS/2 Programme erstellt werden können, die den 
speicherresidenten Programmen unter MS-DOS ähneln, ist 
dieser Artikel gewidmet. 
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Bild 1: Die Installationsmeldung von BILDOS2. 


Wir stellen Ihnen die konzeptionellen Grundlagen, die 
wichtigsten API-Funktionen zur Implementierung von 
Gerätemonitoren und ein nützliches Programm vor, mit 
dem Sie unter OS/2 Hardcopies von Textbildschirmen 
erstellen können, die dann mit dem in der März/April-Aus- 
gabe des MSJ vorgestellten Programm BW.EXE in das 
WORD-Dateiformat konvertiert werden können. 


Bedienung von BILDOS2 


BILDOS2 wird mit dem OS/2-Befehl DETACH als Hin- 
tergrundprozeß gestartet. Rufen Sie von der OS/2-Befehls- 
ebene das Programm folgendermaßen auf: 


[C:\]detach bildos2 


Das Programm wird nun als Hintergrundprozeß für die 
aktive ScreenGroup installiert, ein Info-Fenster informiert 
Sie über diesen Vorgang (Bild I). Ab diesem Zeitpunkt 
können Sie durch Eingabe der Tastenkombination 
den Inhalt des aktuellen Textbildschirms in eine 
Datei schreiben lassen. Hierbei werden auch die Attribute 
der Zeichen übernommen, damit Sie die so erhaltenen Bild- 
Dateien mit dem Programm BW.EXE (vgl. MSJ März/ 
April 89) in das Word-Dateiformat konvertieren können. 
(Wenn Sie die Konvertierung der Bild-Dateien unter OS/2 
durchführen wollen, ist es erforderlich, das Programm 
BW.EXE mit der OS/2-Version des MSC 5.1-Compilers 
neu aufzubauen. Am Quellcode von BW.C brauchen dazu 
jedoch keine Änderungen vorgenommen werden.) 

Die Bild-Dateien werden von BILDOS2 in dem Ver- 
zeichnis abgelegt, aus dem heraus Sie das Programm gestar- 
tet haben. Auch ein späterer Wechsel des Verzeichnisses 
hat darauf keinen Einfluß. Der Versuch, BILDOS2 in der 
gleichen ScreenGroup ein zweites Mal zu installieren, endet 
mit einer Fehlermeldung. Sie können BILDOS2 jederzeit 
durch Eingabe der Tastenkombination 
wieder entfernen. 
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Bild 2: Datenfluß ohne installierten Tastatur-Monitor. 


Der Datenstrom unter OS/2 


Was ist nun ein Gerätemonitor? Ein Gerätemonitor ist ein 
Programm, das bestimmte Funktionen des OS/2 API be- 
nutzt, um Zugriff auf den Datenstrom eines Gerätetreibers 
zu erhalten und ihn überwachen zu können (monitoring). 
Monitore können für folgende OS/2-Gerätetreiber instal- 
liert werden: Tastatur, Maus und Drucker. Bei den block- 
orientierten Geräten (Platte) ist die Verwendung eines 
Monitors nicht möglich. Der Übersichtlichkeit wegen 
beschränken wir uns bei den folgenden Ausführungen auf 
Gerätemonitore, die die Tastatur überwachen. 

Die Möglichkeit, daß beispielsweise der Datenstrom von 
der Tastatur problemlos abgefangen werden kann, hängt 
mit der Organisation des Datenflusses unter OS/2 zusam- 
men, den wir uns nun ansehen wollen (Bild 2). 

Das von der Tastatur eingelesene Zeichen wird zuerst 
an den Gerätetreiber weitergereicht. Von dort aus erreicht 
es den Betriebssystemkern, der beispielsweise mit der 
Funktion KbdCharIn( ) von einer Anwendung angewiesen 
wurde, ein Zeichen einzulesen. Auf diesem Wege wird das 
Zeichen weiterbearbeitet und gefiltert. Die Tastenkombi- 
nationen, mit denen beispielsweise der Session-Manager 
aktiviert oder zu einer anderen Screen-Group umgeschaltet 
werden kann, werden auf diesem Wege verschluckt und 
bleiben dem Anwendungsprogramm verborgen. Das 
Geheimnis der Funktionsweise eines Monitors besteht 
darin, das die Daten nie vom Gerät direkt an ein Anwen- 
dungsprogramm gehen, sondern immer die Umleitung über 
das Betriebssystem fahren müssen. 

Ist ein Monitorprogramm installiert, sicht der Datenfluß 
ein wenig anders aus (Bild 3). Wenn ein Zeichen über die 
Tastatur eingegeben wird, ist der Gerätetreiber der erste, 
der über das eintreffende Zeichen informiert wird. Da nun 
ein Monitorprogramm installiert ist, das die eintreffenden 
Tasten erhalten soll, werden die Tastaturdaten vom 
Betriebssystem zuerst in einen vom Monitorprogramm 
bereitgestellten Eingabepuffer kopiert. 
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Bild 3: Datenfluß mit installiertem Tastatur-Monitor. 


Das Monitorprogramm kann die eingehenden Daten 
lesen, wodurch sie aus dem Eingabepuffer in den lokalen 
Datenpuffer des Monitors kopiert werden. Dort - und auch 
nur dort - darf das Monitorprogramm die Daten 
untersuchen. Entdeckt das Programm einen der Hot-Keys, 
kann es die zugehörige Programmfunktion aktivieren. Dazu 
gehört auch die Möglichkeit, die Taste verändert weiterzu- 
reichen (beispielsweise Klein- in Großbuchstaben umzu- 
wandeln oder umgekehrt) oder sie überhaupt nicht mehr an 
den Gerätetreiber zurückzuschicken. 

Wenn die untersuchte Taste unverändert oder modifi- 
ziert weitergereicht werden soll, wird sie, durch Aufruf 
einer entsprechenden API-Funktion, aus dem lokalen 
Datenpuffer des Monitors in den Ausgabepuffer, der vom 
Betriebssystem kontrolliert wird, kopiert. Sind für das glei- 
che Gerät weitere Monitore installiert, werden die Daten, 
bevor sie das sich im Vordergrund befindende Programm 
erreichen, von einem zum nächsten Monitor weitergereicht. 

Um den beschriebenen Datenfluß zu ermöglichen, muß 
das Monitorprogramm drei Datenpuffer einrichten, die alle 
die ein- bzw. ausgehenden Daten erhalten. Das Format die- 
ser Puffer, die von Gerätemonitoren benutzt werden, ist 
genau definiert. Am Beispiel der Tastatur-Monitore wollen 
wir sie uns genauer anschen. 


Die Datenstrukturen für Tastatur-Monitore 


Das Format der Ein- und Ausgabepuffer, die vom Betriebs- 
system benutzt werden, ist ganz einfach. In den ersten 16 
Bit muß die Größe des Puffers enthalten sein. Der Puffer 
selbst sollte mindestens 64 Byte groß sein, wobei jedoch 128 
Byte empfehlenswert sind. Wir gehen hier auf Nummer 
Sicher und geben die Größe des Buffers in der Struktur- 
deklaration von MONBUFF mit 128 Byte an (Bild 4). 

Diese - und auch die nächste Struktur KEYPACKET - ist 
in den Header-Dateien des OS/2-SDK nicht enthalten. 
Wenn Sie häufiger Monitor-Applikationen erstellen, ist es 
also ratsam, sie in cine eigene Header-Datei aufzunchmen. 
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typedef struct u { % Seskun Ein-/Ausgabepuffer Y 


Länge von UFF 


unsigned 
/* vom System benutzt */ 


len 
2 char buffer[128]; 


Bild 4: Die Struktur MONBUFF dient der Datenübertragung 
zwischen dem Gerätetreiber und dem Monitorprogramm. 


Byte Offset 


E % Gerätetreiberflags 
Tastaturdaten, Bild 8 Bild 18 
Monitorflags, Bild 7? 


Bild 5: Das Datenpaket für Tastatur-Monitore. 


typedef struct tag_KeyPacket{ /* Struktur Tastatur-Datenpack */ 
unsigned monflags; /* Monitor Flag-Word */ 
unsigned char ascii; /* Taste: ASCII-Code 
unsigned char scan; /* Taste: Scan-Code 

/* Sprachensupport 

/* Status Shift-Tasten 

/* Zeit Tastendruck 

/* Flags Gerätetreiber */ 


unsigned nls; 


shift; 
keytime; 
ddflags; 


unsigned 
unsigned long 
unsigned 
YPA 


Bild 6: Der Struktur KEYPACKET können Informationen über 
die eingegebene Taste entnommen werden. 


Die beiden Variablen MonInBuf und MonOutBuf vom 
Typ MONBUFF werden im Listing (Abschnitt »globale 
Daten«) definiert und im Initialisierungsteil der Funktion 
main( ) wird in das erste Word der Struktur die Größe des 
Puffers eingetragen. Der Aufbau des lokalen Datenpuffers 
wird durch die Informationen bestimmt, die bei jedem 
Tastendruck an den Monitor übermittelt werden (Bild 5). 

Jedes Tastatur-Datenpaket ist 14 Byte groß, wobei sich 
in den ersten beiden Bytes das Monitor-Flag-Word befin- 
det, das in ein wenig veränderter Form bei allen Monitor- 
Datenpaketen Verwendung findet. Ab Offset 2 befinden 
sich die eigentlichen Tastaturdaten. Dieses Feld ist 10 Byte 
groß und entspricht der Struktur KBDKEYINFO, die in der 
Header-Datei bsesub..h definiert ist. Die gleiche Struktur 
wird beispielsweise von der API-Tastatur-Eingabefunktion 
KbdCharIn( ) verwendet. Last but not least finden wir ab 
Offset 12 das Gerätetreiber-Flag-Word, dem wir zusätzliche 
Informationen entnehmen können. Alle Tastatur-Informa- 
tionen werden über die Struktur KEYPACKET, die das in 
Bild 6 beschriebene Muster besitzt, in BILDOS2 ausgewer- 
tet. Fangen wir mit dem Monitor-Flag-Word an (Bild 7). 
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Bit Position 


Original Hardware-ScanCode 


öffnen-Befehl 
Schliegen-Befehl 
Flush-Befehl 
reserviert 


Bild 7: Das Monitor-Flag-Word. 


Byte Offset 


m je rn de er | 
| I L Zeit des Tastendrucks 


Shift-Status (Bild 6) 


NLS-Status (Unterstützung andere Zeichensätze) 
Scan- oder erweiterter Tastaturcode 
ASCII-Code des Zeichens 
(oder 8, wenn erweiterter Code) 


Bild 8: Die Tastaturdaten. 


Im Monitor-Flag-Word finden wir an den Bit-Positionen 
7 bis 0 den Hardware-Scancode, wie er von der Tastatur 
erzeugt wurde. Bit 8 und 9 sind gesetzt, wenn es sich bei den 
einkommenden Daten um einen Öffnen- oder Schließen- 
Befehl handelt. Bit 10 ist von Bedeutung, wenn die Daten 
innerhalb des Monitors gepuffert werden, beispielsweise bei 
einem Drucker-Spooler. Ist dieses Bit gesetzt, muß das 
Monitorprogramm seine Puffer sofort leeren und die Daten 
weiterreichen. Die Bits 15 bis 11 sind reserviert und sollten 
nicht benutzt werden. 

Diesem Flag-Word entspricht das Strukturelement 
monflags der Struktur KEYPACKET (siehe Bild 6). 

Im ersten Byte der Tastaturdaten (Bild 8, Strukturele- 
ment ascii von KEYPACKET) finden wir den ASCII-Code 
des eingegebenen Zeichens. Wurde eine Taste mit einem 
erweiterten Tastaturcode (beispielsweise eine Funktions- 
oder Cursortaste) eingegeben, befindet sich hier eine 0, und 
an Byte 1 (Strukturelement scan) der Scancode der Taste. 

Die Bytes an Offset 2 und 3 (NLS-Status, National lan- 
guage Support) dienen der Unterstützung von Zeichensät- 
zen, die mit dem ASCII-Code nicht erfaßt werden können, 
sondern zur Darstellung des Zeichensatzes zwei Byte benö- 
tigen (DBCS=double byte character set) und bleiben hier 
unberücksichtigt. 

Das Wort ab Offset 4 enthält den Status der Shift- 
Tasten, der bitweise kodiert und nach dem Muster, das Sie 
in Bild 9 sehen, abgelegt ist. (R ist die Abkürzung für 
Rechts, L für Links.) 

Ab Byte 6 wird der Zeitpunkt der Tasteneingabe in 
Millisekunden nach dem Systemstart angegeben. 
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Bit Position 


R Umsch unten 
L Umsch gedrückt 


R/L Strg gedrückt 
R/L Alt gedrückt 
Rollen aktiv 
Num aktiv 


Caps Lock Aktiv 
Einfg aktiv 
L gi ar 
L Alt ge ückt 
R Strg gedrückt 
R Alt ge ückt 
ScrollLock gedrückt 
NumLock gedrückt 
CapsLock ge ückt 
S-Abf gedrückt 


Bild 9: Das Shift-Status-Word. 


Bit Position 


Feld für spezielle Aktionen 
Paket durch Loslassen generiert 
2. Byte eines aus 2 Byte 


bestehenden Scancodes 
Wiederholfunktion Shift-Taste 
Akzentkennung 
reserviert (müssen @ sein) 
stehen zur Kommunikation der Monitore untereinander 
zur Verfügung 


Bild 10: Die Gerätetreiber-Flags. 


Beim Gerätetreiber-Flag-Word (Bild 10) interessiert uns 
für unsere Zwecke besonders Bit 6, das gesetzt ist, wenn das 
Datenpaket durch Loslassen einer Taste zustandegekom- 
men ist. Die anderen Bitfelder sind der Vollständigkeit hal- 
ber nur kurz erwähnt. 

Soweit die benötigten Datenstrukturen. Sie sehen, die 
Informationen, die OS/2 Ihnen zur Verfügung stellt, sind 
wegen ihrer Vielfalt ein wenig verwirrend. Bei den meisten 
Tastatur-Gerätemonitoren reicht die Verwendung von drei 
Daten meist vollkommen aus: der ASCII-Code und der 
Scan-Code der Taste sowie die Information, ob das Daten- 
paket durch Loslassen der Taste erzeugt wurde. Auch 
BILDOS2 kommt mit diesen drei Informationen aus. 

Strukturen allein reichen jedoch nicht aus. Wir wollen ja, 
wie oben beschrieben, den Datenfluß an unser Monitorpro- 
gramm umleiten. Und da greift uns das OS/2-API mit den 
speziell für Gerätemonitore zur Verfügung stehenden 
Funktionen voll unter die Arme. 
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DosMonOpen(GeräteName, MonHandle); 
char far *GeräteName; /* Name des Gerätes, KBD$, MOUS$, PRN */ 


/%* Adresse, über die von 05/2 eine */ 


unsigned *MonHandle; 
/* Handle zurückgegeben wird % 


Bild 11: Die Funktion DosMonOpen( ). 


DosMonReg(MonHandle, InBuf, OutBuf, Pos, Index); 

unsigned MonHandle; /#* Handle von DosMonOpen( ) 

char far *InBuf; /* Eingabe-Puffer für Betriebssystem 
/%* Ausgabe-Puffer für Betriebssysten 
ewünschte Position des Monitors 
ei Tastatur/Maus: ScreenGroup 


char far *OutBuf; 
unsigned Pos; /% 
unsigned Index; /# 


Bild 12: Die Funktion DosMonReg( ). 


Gerätemonitore und das API 


Insgesamt sind nur fünf verschiedene Funktionen des API 
erforderlich, um einen Gerätemonitor zu installieren und 
um die Datenpakete zu verarbeiten. Zu Programmanfang 
muß mit der Funktion DosMonOpen() (Bild II) eine 
Handle für das Gerät, in dessen Datenstrom der Monitor 
installiert werden soll, angefordert werden. Durch die 
Anforderung der Handle wird der Gerätetreiber darüber 
informiert, daß ein Monitor installiert werden soll. Wenn 
GeräteNanme einen String mit dem logischen Namen eines 
Gerätes, daß Monitore unterstützt, enthält, erhält das 
Monitorprogramm über die Adresse MonHandle eine 
Handle, die für weitere Bezüge gesichert werden muß. 

Der nächste Schritt besteht darin, den Monitor vom 
Betriebssystem registrieren und einrichten zu lassen. Dazu 
wird die Funktion DosMonReg( ) aufgerufen (Bild 12), mit 
der die vom Betriebssystem benutzten Datenpuffer bereit- 
gestellt und installiert werden. Der Funktion DosMonReg( ) 
wird als ein Argument die von der Funktion DosMon- 
Open( ) erhaltene Handle übergeben. Zwei weitere Argu- 
mente, InBuf und OutBuf, erhalten die Adressen der Ein- 
und Ausgabepuffer, die nicht vom Monitorprogramm, son- 
dern vom Betriebssystem genutzt werden, um die Daten an 
den Monitor zu übertragen und sie vom Monitor an den 
nächsten Monitor in der Kette weiter- bzw. zum Geräte- 
treiber zurückzureichen. 

Mit dem Argument Pos kann festgelegt werden, an wel- 
cher Stelle der Monitorkette der neu einzurichtende Moni- 
tor plaziert werden soll. Der Monitor kann an die erste oder 
letzte Position in der Kette installiert werden oder durch die 
Angabe einer Kennziffer bestimmen, daß die Position keine 
Rolle spielt. Ein Monitor, der sich an der ersten Stelle der 
Kette befindet, hat somit auch zuerst die Möglichkeit, das 
Datenpaket zu erhalten und damit zu modifizieren. 
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DosMonRead(InBuf, WaitFl 
char far "InBuf; /# 
unsigned haitFlag; 


‚ DataBuf, ByteCnt); 
etriebssysten-Puffer 

/* 8= warten, I = nicht warten 

/* Puffer für Tastatur-Datenpaket */ 
/* Größe von DataBuf ”/ 


char far “DataBuf; 
unsigned "ByteCnt; 


Bild 13: Die Funktion DosMonRead( ). 


Die Kontrolle über die Daten, die vom Gerätetreiber 
bereitgestellt werden, ist somit am direktesten. Der Vorteil 
bei der Installierung am Ende der Kette besteht darin, daß 
der sich dort befindende Monitor alle Datenpakete schen 
und auch modifizieren kann, die von anderen Monitoren 
abgeschickt wurden. Auch wenn eine bestimmte Position in 
der Kette angefordert werden kann, besteht keine Garantie, 
daß sich das installierte Monitorprogramm auch an der 
gewünschten Stelle befindet. Darüber hinaus wird der 
Gerätemonitor auch nicht darüber informiert, an welcher 
Stelle in der Kette er sich befindet. Das erste Monitor- 
programm, daß die Positionierung am Anfang oder Ende 
der Kette anfordert, wird normalerweise auch dort plaziert. 
Programme, die später an der gleichen Stelle plaziert wer- 
den wollen, erhalten immer die nächste oder (bei Program- 
men, die am Ende installiert werden sollen) die vorher- 
gehende Position. Das fünfte Argument, Index, wird im 
Zusammenhang mit logischen Geräten benutzt. Da von 
OS/2 ein Drucker unterstützt wird, sollte dieses Argument 
bei Druckern den Wert 0 haben. Bei Monitorprogrammen, 
die die Tastatur oder Maus unterstützen, erhält dieses 
Argument die Identifikationsnummer der Bildschirmgrup- 
pe, für die das Monitorprogramm installiert werden soll. 
Wenn ein Monitorprogramm im Hintergrund gestartet 
wird, ist es nicht mit einem bestimmten Vordergrundprozeß 
verknüpft. Die Verknüpfung des Monitorprogrammes mit 
einer ScreenGroup wird durch die Angabe der Identifika- 
tionsnummer der gewünschten Bildschirmgruppe erreicht. 
Die zur Ermittlung dieser ID notwendigen Schritte sehen 
wir uns noch genauer an. 

Nachdem das Monitorprogramm erfolgreich installiert 
ist, kann der Datenstrom, der vom Treiber ausgeschickt 
wird, überwacht werden. Hierzu wird die Funktion Dos- 
MonRead( ) (Bild 13) eingesetzt. Mit dieser Funktion wer- 
den die einkommenden Daten gelesen (eigentlich von 
InBuf nach DataBuf kopiert) und können nun vom Moni- 
torprogramm untersucht werden. 

DosMonRead( ) werden folgende Argumente über- 
geben: InBuf erhält die Adresse des Eingabepuffers, der 
auch an die Funktion DosMonReg( ) übergeben wurde. 
Über das zweite Argument kann festgelegt werden, ob auf 
das nächste Datenpaket gewartet, oder, wenn keinen Daten 
vorliegen, mit einem Fehlercode an die aufrufende Funk- 
tion zurückgekehrt werden soll. Liegen Daten vor, kopiert 
das Betriebssystem die Informationen aus dem Eingabe- 
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DosMonkrite(OutBuf, DataBuf, ByteCnt); 
char far *OutBuf; 
char far "DataBuf; 


/# Systen-Ausgang-Puffer ”/ 
/* Tastatur-Datenpaket */ 


unsigned ByteCnt; /* Größe von Da f “/ 


Bild 14: Die Funktion DosMonWrite(). 


DosMonClose(MonHandle); 


unsigned MonHandle; /* Handle, der von DosMonOpen() e 
* 


/®* zurückgegeben wurde 


Bild 15: Die Funktion DosMonClose( ). 


puffer in den lokalen Puffer des Monitorprogramms, in dem 
eingekommene Daten untersucht werden können. Das For- 
mat von DataBuf ist Ihnen ja bereits bekannt. Üblicher- 
weise wird ein Monitorprogramm für die Tastatur auf den 
Hot-Key warten, mit dem es seine Aktivitäten starten soll. 

Der Aufruf der Funktion DosMonWrite() (Bild 14) 
kopiert den Inhalt des lokalen Puffers DataBuf in den mit 
DosMonReg( ) registrierten Ausgabepuffer OutBuf. An 
dieser Stelle hat das Monitorprogramm die Kontrolle dar- 
über, ob die eingelesene Taste weitergereicht, eine andere 
Taste in den Datenstrom eingegeben oder auch mehrere 
Datenpakete in den Datenstrom geschrieben werden. 

Typischerweise wird ein weiterer Hot-Key dazu benutzt, 
um das Monitorprogramm wieder zu deinstallieren. Die 
teilweise bei MS-DOS auftretenden Probleme bei Deakti- 
vieren eines TSR-Programms, und die Tatsache, das meist 
nur das zuletzt installierte Programm wieder entfernt wer- 
den kann, entfallen bei OS/2 völlig. Durch Aufruf der 
Funktion DosMonClose( ) (Bild 15) kann zu einem belie- 
bigen Zeitpunkt der Monitor wieder entfernt werden. Diese 
Funktion erhält als einziges Argument die Handle, die mit 
der Funktion DosMonOpen( ) angefordert wurde. 

Nachdem die grundlegenden Schritte bei der Program- 
mierung eines Gerätemonitors erläutert worden sind, wol- 
len uns nun besonderen Fragen im Detail zuwenden. 


Die Ermittlung der Identifikationsnummer des 
Vordergrundprozesses 


OS/2 verwaltet zwei Informationssegmente, von denen das 
globale Informationssegment Prozeßinformationen enthält, 
die für alle derzeit installierten Prozesse gültig und zugäng- 
lich sind. Im lokalen Informationssegment sind Informatio- 
nen enthalten, die spezifisch für einen Prozeß sind, und nur 
von ihm gelesen werden dürfen. 

Zur Installation eines Gerätemonitors für die Tastatur, 
der ja im Hintergrund ablaufen soll, benötigen wir als Argu- 
ment für DosMonReg() die Identifikationsnummer der 
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DosGetInfoSeg(GlobalSeg, LocalSeg); 
unsigned *GlobalSeg; /* erhält Selektor globales Segment */ 


unsigned *LocalSeg; /* erhält Selektor lokales Segment */ 


Bild 16: Die Funktion DosGetInfoSeg( ) ermittelt die 
Selektoren für das globale und lokale Informationssegment. 


DosSetPrty(Scope, Class, Delta. ID); 
unsigned Scope; /* legt Einflupbereich fest 
/* 8: angegebener Prozep/alle Threads 
/* 1: angegebener Prozeß und alle Kind- 
/*  prozesse “/ 
/* 2: ein Thread im aufrufend. Prozeß 
/* Klasse, die zugewiesen werden soll 
/* Veränderung der Stufe (-31 bis +31) 
/* Prozeß-ID, wenn Scope == @ oder 1; 
/* Thread-ID, wenn Scope == 2 


unsigned Class; 
unsigned Delta; 
unsigned ID; 


Bild 17: Die Funktion DosSetPrty( ) ermöglicht die Verän- 
derung der Priorität eines Prozesses oder Threads. 


SereenGroup, die sich im Vordergrund befindet. Glückli- 
cherweise können wir dieses Datum dem globalen Informa- 
tionssegment entnehmen. Wir verwenden dazu die Funktion 
DosGetInfoSeg( ), die uns je einen Selektor für das glo- 
bale und lokale Informationssegment zurückgibt (Bild 16). 

In der Funktion AktiveSGroup( ) leiten wir aus diesen 
Selektoren Zeiger ab, mit dem wir auf die in der Header- 
Datei bsedos.h deklarierte Struktur GINFOSEG zugreifen 
können. Dem Strukturelement sgCurrent (an Offset 18h) 
entnehmen wir dann die Identifikationsnummer der Bild- 
schirmgruppe, die sich beim Aufruf von BILDOS2 im Vor- 
dergrund befindet. 


Prioritäten der verschiedenen Monitor-Threads 


Wie Sie bereits wissen, können für den Gerätetreiber der 
Tastatur mehrere Monitorprogramme eingerichtet werden. 
Da die Informationen über die eingegebenen Tasten, bevor 
sie die im Vordergrund befindliche Anwendung erreichen, 
durch alle Monitorprogramme laufen, ist es wichtig, die zur 
Untersuchung der erhaltenen Daten benutzte Zeit so gering 
wie möglich zu halten. Wir müssen dafür sorgen, daß der 
Thread, der die Tastatureingaben untersucht, möglichst viel 
CPU-Zeit zugeteilt bekommt. 

Das Multitasking-Konzept von OS/2 ermöglicht es, für 
Prozesse oder Threads innerhalb eines Prozesses die Prio- 
rität zu verändern. Hier gilt: Je höher die Priorität, desto 
mehr CPU-Zeit wird dem Prozeß oder Thread von OS/2 
zur Verfügung gestellt. Die Priorität läßt sich durch die 
Zugehörigkeit zu einer Klasse oder Stufe bestimmen. OS/2 
kennt drei Prioritätsklassen: zeitkritisch, normal, und faul. 
Jede Klasse wird außerdem in 32 Stufen (0 - 31) unterteilt. 
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DosAllocShrSeg(Size, Name, Selektor); 
unsigned Size; 


/* Größe des Segmentes “/ 
char far “Name; /* Zeiger auf Segmentnamen */ 
unsigned far *Selektor /* Adresse für Selektor / 


Bild 18: Die Funktion DosAllocShrSeg( ) fordert ein 
gemeinsam benutzbares, benanntes Segment an. 


Mit der API-Funktion DosSetPrty() (Bild 17) kann 
die Priorität von Prozessen verändert werden, wenn in 
CONFIG.SYS der Befehl priority=dynamic steht. 

Damit KbdThread( ) möglichst viel Zeitscheiben er- 
hält, weisen wir ihm die zeitkritische Prioritätsklasse zu, 
lassen jedoch seine Stufe unverändert. 


Mehrfache Installation vermeiden 


Eine der goldenen Grundregeln der Programmierung in 
einer Multitaskingumgebung lautet: »Verwende so wenig 
Speicherplatz wie möglich«. Aus diesem Grunde ist es wün- 
schenswert, beim Laden eines Monitorprogramms zu über- 
prüfen, ob für die derzeit aktive ScreenGroup (die Bild- 
schirmgruppe, die sich im Vordergrund befindet) der Moni- 
tor bereits installiert wurde. 

Diese Überprüfung durchzuführen ist ein einfaches 
Unternehmen: Wir verwenden hierzu den Mechanismus des 
gemeinsam benutzbaren Datensegments (Shared Segment). 
Diese Technik wurde eigentlich für den Datenaustausch 
zwischen verschiedenen Prozessen oder Threads implemen- 
tiert, eignet sich jedoch für unsere Zwecke hervorragend. 
Ein Shared Segment wird im Speicher angelegt und erhält 
einen Pfadnamen, über den es dann ansprechbar ist. Dieser 
Pfadname muß mit dem Verzeichnisnamen \SHAREMEM 
beginnen, danach kann der Name eines Unterverzeichnisses 
folgen, der Name des benannten Segments ist vorgeschrie- 
ben und folgt den DOS-Konventionen für Dateinamen. 

Mit der Funktion DosAllocShrSeg( ) (Bild 18) wird 
dieses gemeinsame benutzbare Datensegment angefordert. 
Die Funktion erhält als Argumente die Größe des 
angeforderten Segmentes, einen Zeiger auf dessen Namen 
und einen Zeiger, über den die Funktion einen Selektor auf 
das Segment zurückgibt. Da wir über das Vorhandensein 
des Shared Segments überprüfen wollen, ob das 
Monitorprogramm bereits installiert ist, begnügen wir uns 
mit einer Größe von einem int. 

Diese API-Funktion gibt den Fehlercode 183 zurück, 
wenn ein Datensegment gleichen Namens bereits existiert. 
Somit fällt auf Grund des Rückgabewertes der Funktion die 
Entscheidung, ob das Programm bereits installiert worden 
ist oder nicht. Ist dies der Fall, wird das Programm mit 
einer entsprechenden Meldung, die den Anwender über den 
Abbruch der Installation informiert, beendet. Anderenfalls 
wird die Installationsroutine fortgeführt. 
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05/2 


‚ VioHandle); 
je Bit 8: 


/" Bit 1: 
/" 


VioPopUp (WaitFl 
unsigned *WaitF ag; 


8 = nicht warten, 

1 = auf Bildschirm varten 
8 = nicht transparent 

1 = transparent 


unsigned VioHandle; /* derzeit inner 8 


Bild 19: Die Funktion VioPopUp(). 


VioEndP (VioHandle); 
2. /* derzeit immer 8 


unsigned VioHandle; 


Bild 20: Die Funktion VioEndPopUp(). 


Bildschirmausgabe durch einen 
Hintergrundprozeß 


Das letzte Problem, das wir noch lösen müssen, besteht 
darin, dem im Hintergrund gestarteten Prozeß Zugriff auf 
den Ausgabebildschirm zu ermöglichen. Dies ist zum einen 
erforderlich, um die Info-Fenster auszugeben, zum anderen 
muß das Programm Zugang zum Bildschirm haben, um sei- 
nen eigentlichen Zweck, die Erstellung von Dateien mit 
dem Inhalt des Bildschirms, erfüllen zu können. 

Normalerweise hat ein Hintergrundprozeß keinen Bild- 
schirmzugriff. Er kann ihn über die API-Funktion VioPop- 
Up() anfordern (Bild 19) und dabei angeben, ob auf das 
Freiwerden des Bildschirms gewartet werden soll oder 
nicht. Wenn der Hintergrundprozeß den Bildschirm erhält, 
sichert das Betriebssystem den aktuellen Zustand des Bild- 
schirms. Eine weitere Option von VioPopUp( ) legt fest, ob 
der Bildschirm nach dem Sichern gelöscht werden (nicht 
transparent) oder unverändert (transparent) bleiben soll. 

Wir verwenden an beiden Stellen im Programm, die die 
Pop-up-Funktionen benutzen - im Thread BildThread( ) 
und der Funktion ZeigeWindow( ) - die Option »warten, 
nicht löschen«. Den daraus resultierenden Effekt können 
Sie beobachten, wenn Sie das Programm installieren, in ein 
Verzeichnis mit einer großen Anzahl von Dateien wechseln, 
den DIR-Befehl eingeben und mit BILDOS2 
den Befehl zum Speichern des Bildschirms geben. 
BILDOS2 erhält erst dann Zugriff auf den Bildschirm, 
wenn der DIR-Befehl beendet wurde. Während des Pop- 
ups können die üblichen Ausgabefunktionen des Vio- 
Moduls benutzt werden. 

Der temporäre Bildschirmzugriff wird über die Funktion 
VioEndPopUp( ) wieder freigegeben (Bild 20) - was so 
schnell wie möglich passieren sollte. Eine Einschränkung 
der Pop-up-Funktion besteht darin, daß immer nur ein Pop- 
up-Bildschirm zur gleichen Zeit aktiv sein kann. Wenn ein 
anderes Programm diesen temporären Bildschirm besitzt, 
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muß das weitere anfordernde Programm so lange warten, 
bis der andere Prozeß diesen wieder freigegeben hat. 


Die Realisierung der Hardcopy-Funktion 


Die mit BILDOS2 erstellten Bildschirmhardcopies sind für 
den 80x25 Textbildschirm immer 4000 Bytes groß, da 
sowohl sämtliche Zeichen, als auch die zugehörigen Attri- 
bute des Bildschirms gesichert werden können. Dieses 
Format wurde gewählt, damit mit dem in der März/April- 
Ausgabe von MSJ beschriebenen Programm BW.EXE 
Dateien erstellt werden können, in denen die erforderlichen 
Attribute des Textes im Word/Datei-Format enthalten sind. 
Wurde entdeckt, daß der Aktivierungs-Hotkey eingegeben 
wurde, wird ein Thread gestartet, der die 2000 Zeichen mit 
ihren Attributen in einen dynamisch allokierten Datenpuf- 
fer ablegt. Wurde der Bildschirminhalt einmal gesichert, 
kann das Vordergrund-Programm weiterlaufen. Dieser 4 
Kbyte große Puffer wird nach dem Sichern des Bildschirm- 
inhalts in der Datei wieder freigegeben. 

Mit der Funktion DosOpen( ) wird die Datei, in die der 
Bildschirminhalt geschrieben werden soll, geöffnet, die 
Daten mit DosWrite( ) weggeschrieben und abschließend 
mit DosClose( ) die Datei wieder geschlossen. 

Rainer G. Haselier 


Pd EEE 


/* Datei: bildos2.c “/ 
[NER BEE BENENNEN 


1.83 

12. 1 = 

2 3. 

cl -AS 0 "2 -G2 -W3 bildos2.c 
detach bildos 


Gerätemonitor für 05/2, mit dem Hardcopy- */ 
Dateien von Text-Bildschirmen im Modus */ 
88 Spalt./25 Zeilen erstellt werden können*/ 
Mit dem Programm bw.exe (siehe MSJ März/ */ 
April 89) können die Dateien in das Word- 
Dateiformat umgewandelt werden. 


Die Hardcopy-Dateien werden in das akt. 
Verzeichnis chrieben und erhalten den 
Namen BILD) .BLD, wobei die Bilder bei 
& beginnend durchnumeriert werden. 


Jana / 
n (e) copyright 1988,1989 rabbitsoft Rainer G. Haselier 2 
” 


Alle Rechte vorbehalten. 
ie 


/# MEET EIERTERen “ 
für 


/% rintf(), ... “/ 
/* für Perlen) “/ 


#include <string.h> 
/* für malloc() “/ 


include <malloc.h> 


Listing 1: BILDOS2.C 


Juli/August 1989 


0S/2 


/" nögl. Ar e Buch tu “/ 
/# io Positionswunsch für #/ 
/n Monitor fest, hier: 1 %#/ 


/* Monitor wartet auf Eingabe */ 
/* Hotkeys festlegen “/ 
/* Taste mit erweitertert. Code*/ 
/* Alt+Enter macht Bild ”/ 
/* Alt+Backspace Ende Monitor %*/ 
/* Taste losgelassen “/ 
/* für Datei tionen “/ 
#define ATTR 8 /* normales Datei-Attribut ”/ 
#define OPENFLAG 2x12 /* neue Datei, oder ersetzen */ 
#define OPENMODE 2x8d41 /* nur schreiben/nicht vererben*/ 
#define BYTE_PRO_BILD 4898 /* für Doskrite(): Dateigröße */ 
#define SEGMENT_SCHON_DA 183 /* benutzter API-Fehlercode */ 
#define VIOHANDLE 8 /* derzeit immer 8 “/ 


#define STACKGROESSE 2848 /* Stackgröße neue Threads “/ 


#define WAIT 8 
#define HOT _ASCII 


#define RELEASE ” Bx4B 


[PR BERNER NENNEN 
/# DATENSTRUKTUREN 177 
[PER RHEIN NENNEN NEE 
Spt struct tag _KeyPacket{ /* Struktur Tastatur-Datenpack*/ 
unsigned nonflags; /* Monitor Flag-Word */ 
unsigned char il; /" Taste: ASCII-Code %*/ 
unsigned char 2 
unsigned 
unsigned 5 tus Shift-Tasten*/ 
nn long /* Zeit Tastendruck */ 
it. /* Flags Gerätetreiber*/ 
} KEYPA\ 


typedef struct ta MonBuff { 
unsigned leng 
char buffer[128]; 


ddflags; 


/* Struktur Ein-/Ausgabepuffer*/ 
/®* Länge von “/ 
/* vom System benutzt */ 


[HEHE / 


/* GLOBALE DATEN ”/ 


[RR N N / 


MONBUFF MonInBuf, MonOutBuf; /#* Datentransfer-Puffer ”/ 
KEYPACKET kp; /* Tastatur-Datenpaket “/ 


unsigned long SemPrgEnde = &L; /* Semaphor frei=Pro; -Ende*/ 
unsigned long SemBild = BL; /* Semaphor frei=Bild machen */ 


char cAttr = dx7B; /* Attribut für Info-Fenster #/ 
unsigned BildNr = 8; /* Zähler für Bildnumner “/ 


JRR EHEN NN MN / 


/* INFO-FENSTER “ 


[RER RN RR MH N / 


aaa *apsträktiv[] = 


BildOS2, Version 1.83 
(ce) copyright 1989 rabbitsoft, Rainer G. Haselier. 


Bild erstellen: [Alt]+[Enter] 
Monitor beenden: [Alt]+[Backspace] 


weiter mit beliebiger Taste... 


Listing 1: (Fortsetzung) 
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NULL 
} 


ar *apstrDeAktiv[] = 


Bild0S2, Version 1.83 
Programm in dieser ScreenGroup bereits installiert 


PROTOTYPEN * 


EEE EEE / 


void main(void); 
void zen eWindow(int, ‚Int, int, char#[], char®*); 


void far KbdThread(void); 
unsigned AktiveSGroup(void); 


Panne MN RR 
/# MAIN-FUNKTION ”/ 
0 / 
aa nain(void) 


unsigned u = pen ae 
unsigned s * creenGro 
ie re /# Rückgabevert API 


unsigned short SharSegSel; 
char SharSegName[ 32]; 


.char far *bildStack; 
unsigned bildID; 


char far *kbdStack; 
unsigned kbdID; 


/* Selektor und Name 
/* des Shared Segnent 


/* Stack und ID des 
/* Bild-Thread 


/* Stack und ID des 
/* Tastatur-Threads 


/* Stack allokieren */ 
bildStack = (char far*) malloc(STACKGROESSE) + STACKGROESSE; 
kbdStack = (char far®) malloc(STACKGROESSE) + STACKGROESSE; 


sgCurID = AktiveSGroup(); /* ID aktive Screen- */ 
- /* Group ermitteln */ 


sprintf(SharSegNanme, /®* Name des Shared %/ 
a \BILDOS2.X02u”, /* Segment festlegen*/ 
E) 


ret = Dos ÄllocShrseg(sizeof(int), 


/* Segment anfordern %/ 
SharSegNane, &SharSegSel); 


Listing 1: (Fortsetzung) 
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a a a I En I E22 2 2 22 22 


/®* wenn vorhanden 


if (ret == SEGMENT_SCHON_DA) 
/* Mel gen 


ee 18, 2, apstrSchonDa, &cättr 
Dosßeiten. /® und 


} 

if (DosSenSet(&SemPrgEnde)) 
FehlerEnde(); 

if (DosSenSet(&SemBild)) 
FehlerEnde(); 


/* Senaphore belegen 


/* Größe der Puffer %/ 

/n eintragen ”/ 
MonInBuf,.length = (unsigned) sizeof( MONBUFF); 
MonOutBuf.length = (unsigned) sizeof( MONBUFF); 


if (DosMonOpen("KBD$", &MonHandle)) /* Verbindung zum #/ 
FehlerEnde(); /# Treiber herstellen */ 
if (DosMonReg( MonHandle, /" Monitor registrier.*/ 
Hemer den char *) &MonInBuf, /# lassen “/ 
ug char 2) Mondutbut 
Fehlernde(): 


if (DosCreateThread(KbdThread, 
&kbdID, kbdStack)) 
FehlerEnde(); 


if u ti /* und dessen */ 
PRTYCT ans ß, kbaip))70 Priorität erhöhen */ 
FehlerEnde(); 


if (DosCreateThread(BildThread, 
&bildID, bildStack)) 
FehlerEnde(); 


Zeigehindow(7, 13, 8, /* Installationsnel- */ 
apstrAktiv, &cätir); /* dung ausgeben */ 


if (DosSemkait(&SenPrgEnde, -1L)) /# warten bis Sesaphor®/ 
FehlerEnde(); /#* freigegeben wird®/ 


/" ROUTINEN ZUM BEEN- */ 
/" DEN DES MONITORS %/ 
DosSuspendThread(kbdID); /* laufende Threads */ 
DosSuspendThread(bildID); /# unterbrechen */ 


ZeigeWindow(18, 18, 1, /* Deinstallationsmel-*/ 
apstrDeAktiv, &chttr); /" dung ausgeben #*/ 


an: /* Seguent freigeben #/ 
MonHandle /* Monitor schliessen #/ 
/* zurück zu 05/2 “/ 


/* KbdThread erzeugen */ 


/" BildThread erzeugen*/ 


oben Funktion ermittelt die ID der Screen- * 
Group, die sich derzeit im Vordergrund befin-* 
det. Diese ID wird für die Festlegung des * 
Namens des Shared Segments und zum Begistrie- 
ren des Monitors benötigt. 
N 


ae) 


alla AktiveSGroup(void) 


unsi short infoseg, ne 
struct _GINFOSEG far *globptr 


if (DosGetInfoSeg(&infoseg, &localseg)) 
FehlerEnde(); 
globptr = (struct _GINFOSEG far*) ( (long) infoseg<<16); 


return (globptr->sgCurrent); 


05/2 


* Thread: 
* 


(W - indirekt über API) 
(W - indirekt über API) 
(W - indirekt über API) 
(W - indirekt über API) 
(R - indirekt über API) 


Dieser Thread ist die eigentliche Über- 

va funktion für die Tastatureingaben 
Hier ft, ob die Hotkeys zum Ab- 

speichern ve ildes oder zum Beenden des 

Br deren e n wurden. 
Soll ein Bilgtaßgespeichert werden, wird das * 
SemBild freigegeben, und damit der * 
Thread BildThread() . Wurde der Hot-* 
key zum Beenden des ogrannes entdeckt, wird* 
das Semaphor SemPrgEnde freigegeben, wodurch * 
die Deinstallierungsfunktionen in main() * 
beitet werden können. “ 
Alle anderen Daten werden unverändert an den * 
nächsten Monitor weiter-, oder den Geräte- * 
treiber zurückgegeben. y 
* 


ByteCnt = sizeof(kp); /* Datenpaket lesen %/ 
DosMonRead( (unsigned char*) &MonInBuf, 
WAIT, (char *) &kp, &ByteCnt); 


DREH &%& RELEASE) == 8) /* Taste losgelassen #/ 
ift uR: ascii == HOT Be /* Bild erstellen “/ 


(kp.scan == HOT'S 
Do: lear(&SemBild); /# Semaphor freigeben */ 
/* Programm beenden */ 


else iff Br ascii== HOT Bun &% 
(kp. SCAN_2)) 


/* Daten veiterreichen®/ 
DosMonkrite( (unsigned char*) &MonOutBuf, 
(char*) &kp, ByteCnt); 


BildThread 


#Hi--------- 2 om nn 


keine 
: keiner 
: SemBild (R/W), BildNr (R/W) 


Dieser Thread wird durch die Freigabe des 
ENE aapheen SemBild zum Leben erweckt. 
Mit den API-Popup-Funktionen erhält die 
Funktion Zugang zum Bildschirm der Vorder- 


rg liest den Bildschirain- 
ibt ihn in eine Datei. 
Tritt beim Öffnen der Datei ein Fehler auf, 


werden zwei Warntöne alngegeben. 
IE EEE EEE DIENEN HAHM 


Sue ec x 


Listing 1: (Fortsetzung) Listing 1: (Fortsetzung) 
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08/2 


void far BildThread(void) u 
{ * Beschreibung: Diese Funktion gibt ab der übergebenen 
char far “Puffer = NULL; /* Zeiger auf Puffer */ “ Position (Zeile, te) ein Textwindow aus, 
SEL Selektor; /* Selektor auf Puffer®/ auf dessen ersten String apstrTxt zeigt. 
HFILE hfDatei; /* Datei Handle “/ Alle er. Arrays müssen die gleiche 
unsigned NoClear = Bx83; /* warten, transparent#/ Länge besitzen. Zur Ausgabe wird das 
unsigned Aktion; /* Aktion beim Öffnen */ Attribut, auf das Be zeigt, verwendet. 
unsigned Geschrieben; /* geschriebene Bytes */ Über das Ar us kann gesteuert wer- 
unsigned ByteProBild = BYTE_PRO_BILD; den, wie das Fenster entfernt wird. Hat 
unsigned long Groesse = 9; /* Größe der Datei */ Modus den Wert 8, wird auf eine beliebige 
unsigned char acDateinanel 128]; /* erhält Dateinamen */ Taste gewartet, anderenfalls wird der Wert 
for (;;) von Modus als Argument für DosSleep() 
{ benutzt, und die übergebene Zeit in Sekunden 
DosSemWait( &SemBild, -IL ); /% Warte, bis BURGER, gewartet, bevor der Ursprungsbildschirm 
* 


/* frei wird wieder hergesis}lt wird. 
DosAllocSeg( ByteProBild, /* Puffer anfordern */ RHEIN 


&Selektor, 8) ; /* und Zeiger ableiten®/ void Zeigehindow( int Zeile, int Spalte, int Modus, 
Puffer = (char far®) (((long) Selektor) <<16); it char* apstrTxt[), char* pbAttr) 
KBDKEYINFO Taste; /* für KbdCharIn) 
VioPopUp(&NoClear, VIOHANDLE); /* Schirm anfordern #/ int laenge; /% e des Textes #/ 
VioReadCellStr( Kehe u. /* Inhalt lesen 7 brennen u = BxB3; je . u Ale e I) 
{ı) ” **ppstrTap; * temp. ger Str 
8, 8, VIOHANDLE ); 
VioEndPopUp(VIOHANDLE) ; /" Bono freigeben */ Bere = apstrTxt; /* Adresse zuweisen 
sprintf( acDateinane, /* Dateinamen erzeugen#/ oPopUp(&HaitNoClear, VIOHANDLE); /* PopUp anmelden 
"BILD4B3u.BLD”, BildNr); laenge = strlen(*ppstrTap); /* Länge ermitteln 
if( DosOpen( acDateiname, /* Datei öffnen “/ if (laenge != ß) /* wenn Text da 
&hfDatei, &Aktion, { 
Groesse, ATTR, ai eine t= NULL) /* solange Text da, 
OPENFLAG, OPENMODE, BL) ) ViohrtCharStrAtt(*ppstrTapt+, /* ausgeben 
/* im Fehlerfall “/ laenge, Zeile++, /%* vie Text da 
DosBeep(1888, 588); /# zweinal beepen */ Spalte, pbAttr, VIOHANDLE); 
DosBeep(1808, 588); if (Modus == 8) /* auf beliebige 
KbdCharIn(&Taste, 8, 8); /r Taste varten 
else /* sonst “/ else /* sonst übergebene 
/* Pufferinhalt in w/ DosSleep(Modus * 1888L); /%* Pause einhalten*/ 
Doskrite( hfDatei, Puffer, /* Datei wegschreiben "/ 
BYTE_PRO_BILD, &Geschrieben ); VioEndPopUp(VIOHANDLE) ; /* PopYp freigeben */ 
BildNr++; /* Bildnumner erhöhen */ return; 


DosClose( hfDatei ); /* Datei schlieren ”/ 
DosFreeSeg( Selektor ); /® Speicher freigeben #/ 
DosSenSet( &SemBild ); /* Semaphor belegen */ 
} /* end of for(;;) %/ [RRRGRBRRRERRERRRREDODEODODDGRRGRHBRBRBERBRIREREGRREGGRE 


FehlerEnde 


E SE 22 22 zu ZE Zu zu Zu zu ze: 


* 
Seen ueek 


} 


/ P n ga : Fehlercode 1 an 05/2 über DosExit() 
Zeigehindow apstrFehler (R) 


int Zeile Zeile des Fensters Diese Funktion beendet das Programm nit einer* 
int Spalte Spalte des Fensters Meldung, wenn bei der Installation unerwar- * 
int Modus == f nach Ausgabe auf bel. ” tete Probleme auftreten. ® 
Taste warten MEER / 
> 8 Pause in Sekunden nach void FehlerEnde(void) 
Ausgabe des Fensters 
char* apstrTxt[] Ausgabetext 
char* pbAttr Adresse des Attributes 
* Rückgabewert: keiner 
* Globale Daten: keine 


zu. x 


Zeigehindow(7, 13, 0, /* Meldung ausgeben */ 
apstrFehler, &cAttr); 
DosExit(EXIT_PROCESS, 1 ); /* zurück zu 08/2 “ 


Listing 1: (Fortsetzung) Listing 1: (Ende) 
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Urehain 1 08.Zull (1.2 Milan 
u 1% Lidl Drum 


Microsoft. Excel 


Mdlananchunen htwelkeedunfkukenisnn: Geefik md Doterlumd 


Eın Geschenk 
des Himmels! 


ZWEITER TEIL 


Jetzt öffnen sich wieder die Himmels- 
pforten. Ab sofort gibt es das neue Intel 
Above Board Plus zweimal zum himm- 
lisch günstigen Preis. Das erste heißt 
Management-Package, besteht aus 
Above Board Plus, Microsoft Excel und 
einer Microsoft-Maus. 

Das zweite ist das Windows/286-Package 
und enthält das Board inclusive dem 
Microsoft Windows/286. 

Beide Kombinationen bringen Ihnen 
den Himmel auf Erden: Zeit- und Geld- 
ersparnis durch zwei Pakete, die teuf- 
lisch gut zusammen passen. Von zwei 
führenden Unternehmen der Branche. 


1. Das Management-Package 

Für die Entscheider von morgen heißt 
es nicht mehr nur, Fakten und Zahlen 
zu sammeln. Es gilt, Trends aufzu- 
spüren und Analysen zu erstellen. 
Dafür brauchen Entscheider das beste 
Werkzeug. Sie brauchen das Manage- 
ment-Package. Ex- 
cel nutzt erstmals 
alle Vorteile von 
Windows, erleich- 
tert so den späteren 
Übergang zu 08/2 
und übernimmt 
mühelos alle Daten 
aus Lotus, dBase, 
Multiplan etc. Excel 
vereint Kalkulation, 
Grafik und Daten- 
bank: Sowerdenaus 
Zahlen Strategien 
und aus Informatio- 
nen Entscheidun- 
gen. Und weil die 
neue Microsoft- 
Maus serienmäßig 
zum Package dazu- 
gehört, wird nicht 
nur die Bedienung 
noch einfacher, son- 
dern das Paket auch 


intel 


himmlisch günstig: 
Sie sparen 
435,- DM. 


Above Board 
Plus. 

Mehr Raum für 
kühne Pläne. 


Bi 


Um Himmelswillen, werden Sie jetzt 
sagen, was nützen mir die kühnsten 
Pläne, wenn ich bald an die Grenze der 
üblichen 640 KB stoße? Die Lösung: 
das INTEL Above Board Plus. Mit 
max. 8 MB holt dieses Board die 
maximale Leistung aus Ihrer Software. 
Vorteile, die bereits über 80 professio- 
nelle Programme nutzen. 


2. Das Windows/286-Package 

Sie brauchen mehr Speicher, setzen 
auf INTEL-Qualität und hätten gern 
Multitasking unter WINDOWS/286? 


Unser zweites himmlisches Erlebnis, 
die neuen Above Board Plus Hardware- 
Register für EMS 4.0 
machen all dies möglich: 
Ab sofort gibt es zu je- 
dem Above Board Plus 
das neue Windows/286. 
Und 5 Jahre Garantie. 
Sie sparen 450,-DM. 


7 


Schauen Sie also schnell bei Ihrem 
Händler vorbei. Die Angebote gelten, 
solange der Vorrat reicht. Und es wäre 
doch die Hölle, würden Sie zu spät 
kommen. Wir nennen Ihnen gerne 
einen Fachhändler in Ihrer Nähe. 


COMPUTER 2000 AG 
Baierbrunner Str. 31 
8000 München 70 

Tel. (089) 769 90-0 


Buchauszug 


n iD 


Die I/O-Subsysteme von OS/2 


OSJ/2 enthält eine größere Menge von I/O-Servi- 
ces für jene Devices (speziell Tastatur, Videodis- 
play und Maus), die bei der Implementierung 
einer OS/2-Benutzerschnittstelle besonders 
wichtig sind. Ed Iacobucci, der Chefentwickler 
für OS/2 bei IBM, beschreibt in diesem Artikel 
diese 1/O-Subsysteme. 


System-I/O der unteren Stufe wird für diese Devices von 
speziellen OS/2-Komponenten, den I1/O-Subsystemen, 
durchgeführt. Ein 1/O-Subsystem führt die Grund-I/O- 
Operationen für OS/2-Programme durch. Betrachten Sie 
diese Subsysteme als Pendants des Protected-Mode zu den 
BIOS-Services in der PC-DOS-Umgebung. OS/2 imple- 
mentiert 1/O-Subsysteme für die Tastatur, das Videodisplay 
und die Maus. Jeglicher Input von oder Output für diese 
Devices (ob sie nun von einer Applikation oder dem System 
selber stammen) wird am Ende in eine 1/O-Subsystem- 
Primitive aufgelöst. 


Warum Subsysteme notwendig sind 


Sie mögen sich fragen, warum diese Services existieren. 
Bietet das Dateimodell nicht alle Funktionen, die für den 
Zugriff auf diese Devices erforderlich sind? Die Antwort 
liegt in einem einfachen Kompromiß zwischen Funktion 
und Ansprechbarkeit. Betrachten Sie, wie diese Kompro- 
misse zum Beispiel bei den Video-Services aussehen. 

Das Datei-I/O-Modell kann für Konsolen-I/O einge- 
setzt werden, der auf Handles basiert. Dieses Modell ist 
mehr als ausreichend für »Standard«-I/O-Funktionen, wie 
das Schreiben zur Konsole im Teletype-Mode (TTY). TTY- 
1/O stimmt tatsächlich genau mit dem Datenstrommodell 
für serielle Zeichen überein und ist deshalb mit den OS/2- 
Datei-I/O-Services kompatibel. Die System-Utilities 
schreiben zur Konsole, als ob die Konsole ein TTY-Device 
wäre. Dies bietet offensichtliche Vorteile, da OS/2 dann 
den Output zu anderen Programmen, Devices oder Dateien 
über Pipes schicken oder umleiten kann. 

In der Umgebung des Personalcomputers ist einfaches 
TTY-I/O nicht immer angemessen. Hochentwickelte 
Benutzerschnittstellen verlangen, daß der Bildschirm als 
eine Darstellungsfläche mit wahlfreiem Zugriff auf die ver- 
schiedenen Bildschirmkoordinaten behandelt wird. Dies 
wird ganz klar, wenn man betrachtet, wie »Ganzbild- 
schirm«-Applikationen wie Tabellenkalkulationen den Bild- 
schirm aktualisieren. Ein Spreadsheet-Programm verschiebt 
ein Viewport (den Bildschirm) über einen sehr viel größe- 
ren Darstellungsraum (den Arbeitsraum der Tabellenkal- 
kulation). Teile des Bildschirms werden aktualisiert, wenn 
der Anwender von einem Bereich zum anderen geht. Es ist 
keine praktikable Lösung, den gesamten Bildschirm jedes- 
mal, wenn der Anwender den Cursor bewegt, neu zu 
schreiben. 
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Abbildung 1: Video-L/O in PC-DOS-Applikationen. 


Außerdem macht I/O-Umleitung in dieser Umgebung 
keinen Sinn, da die Schnittstelle visuell ist. Die Bedeutung 
einer jeweilig gedrückten Taste oder eines eingegebenen 
Zeichens wird nur durch die relative Position des Cursors 
innerhalb des Spreadsheets bestimmt. 

Die meisten Ganzbildschirm-Applikationen erfordern 
optimale Video-Leistung, da die Antwortzeit der Schnitt- 
stelle wichtig für die Verwendbarkeit der Applikation ist. In 
der PC-DOS-Umgebung werden Ganzbildschirm-Applika- 
tionsprogramme selten direkt zur INT21-READ/WRITE- 
Schnittstelle geschrieben. Statt dessen bevorzugen die Ver- 
fasser von Applikationen BIOS-Services oder direkten 
Hardware-Zugriff (Memory-Mapped-1/O). 

Gehen Sie in der funktionellen Hierarchie tiefer nach 
unten, gewinnen Sie Leistung, verlieren aber Funktion. 
Abb. 1 zeigt, wie dieses Konzept sich im Fall von PC-DOS- 
Video-I/O auswirkt. Auf der höchsten Stufe greifen Appli- 
kationsprogramme auf die Konsole über das PC-DOS- 
Dateisystem zu. In diesem Fall erhält die Applikation 
Umleitungsdienste, ANSI-Unterstützung und eine Darstel- 
lung des Bildschirms auf hoher Stufe, als ob die Konsole ein 
Dumb-Terminal wäre. Dumb-Terminal ist ein Begriff, mit 
dem Darstellungs-Services ohne lokale Intelligenz beschrie- 
ben werden. Dieser Device-Typ ist häufig so konstruiert, 
daß ein spezieller Datenstrom (wie ANSI, 3270 etc.) unter- 
stützt wird, der in der Regel von einem Host-Computer 
gesendet wurde. 

Ist Datei-I/O-Umleitung nicht wichtig, kann die Appli- 
kation direkt auf die BIOS-Services zugreifen, um wahlfrei 
Zeichen und Zeichen-Attribute zu schreiben. Diese Technik 
bietet bessere Leistung, während gleichzeitig Hardware- 
unabhängigkeit bewahrt und Display-Adapter-Typ, Bild- 
schirmmodus (Grafik oder Text) und charakteristische 
Eigenschaften des Displays von der Applikation abge- 
schirmt werden. 
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Abbildung 2: 1/O-Flüsse in OS/2. 


Am anderen Ende des Spektrums wird höchste Video- 
leistung dadurch erreicht, daß der Videodisplay-Buffer 
direkt beschrieben wird. In diesem Fall muß die Applika- 
tion jedoch alle Charakteristika des Devices verstehen, da 
sie alle Verpflichtungen der System-Videotreiber über- 
nimmt. Anwender, die die Hardware direkt ansprechen, 
sind mit allen Eigenarten einzelner Display-Adapter ver- 
traut (zum Beispiel mit CGA-Retrace-Synchronisation, um 
»Schnee« beim Schreiben von Zeichen zu vermeiden). 

OS/2-1/O-Subsysteme bieten sich Applikationspro- 
grammen an, die auf die Attribute des Standard-I/O zugun- 
sten verbesserter Leistung verzichten wollen. Zahlreiche 
Stufen von Subsystem-Services bieten eine breite Auswahl 
an Schnittstellenstufen (von TTY-ähnlichem Output mit 
voller ANSI-Unterstützung bis zur direkten Hardware- 
Manipulation). 


1/O-Struktur von OS/2 


Ehe wir uns die einzelnen Subsysteme ansehen, soll ihre all- 
gemeine Implementierungs-Architektur betrachtet werden. 
Die 1/O-Subsysteme werden mit dem OS/2-Subsystem- 
modell implementiert. Jedes Subsystem bietet einen Satz 
dynamischer Link-APIs, über die eine Applikation auf 
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Abbildung 3: 1/O-Subsystem-Struktur. 


seine Services zugreifen kann. Jedes Subsystem besitzt eine 
entsprechende DLL-Runtime-Datei und einen Device-Trei- 
ber. Subsystem-Serviceroutinen werden für das aufrufende 
Programm als Subroutine auf PL3 im Kontext (LDT) des 
aufrufenden Programms ausgeführt. 

Abb. 2 zeigt den I/O-Fluß im Gesamtsystem. Auf der 
höchsten Stufe kann ein Applikationsprogramm_ direkte 
Aufrufe an das Dateisystem oder das I/O-Subsystem aus- 
führen. Im Fall von Handle-Device-I/O geht der Aufruf zu- 
erst zum Dateisystem-Router, damit festgestellt wird, ob 
Umleitung vorliegt. Ist das Device umgeleitet, wird der 
Output zum entsprechenden Device oder zur entsprechen- 
den Datei geschickt. Wird das Device nicht umgeleitet, wird 
die Anforderung an ein 1/O-Subsystem zur Erledigung 
übergeben. In jedem Fall wird die Anforderung am Ende 
vom Subsystem bedient. Die 1/O-Subsysteme in OS/2 bil- 
den die alleinige Schnittstelle zur Tastatur, dem Videodis- 
play und den Maus-Devices. 

Benötigt ein Applikationsprogramm keine Umleitungs- 
Services (oder wenn es auf das Device wahlfrei zugreifen 
will), kann das I/O-Subsystem direkt aufgerufen werden. 
Die 1/O-Subsystem-APls sind ein anderer Teil des Gesamt- 
OS/2-API. Wenn das Applikationsprogramm diese APls 
direkt verwendet, verwirkt es das serielle Datenstrommodell 
und seine Umleitungsfähigkeiten, gewinnt aber mehr Kon- 
trolle über das Device. 

Die I/O-Subsystem API-Aufrufe sind stufig strukturiert, 
von den eher primitiven Funktionen bis zu höheren Funk- 
tionen. Im Fall von Video-I/O werden die grundlegenden 
TTY-Fähigkeiten durch eine höhere WriteTTY-Schnitt- 
stelle ohne 1/O-Umleitung implementiert. Aufrufe an 
WriteTTY werden in eine Reihe von Aufrufen zum Schrei- 
ben von Zeichen und zur Cursorpositionierung zerlegt. Be- 
achten Sie, daß in OS/2 die TTY-Services als Teil des I/O- 
Subsystems und nicht im Dateisystem implementiert sind. 


Ersetzen von 1/O-Subsystem-Funktionen 


Da das gesamte OS/2-I/O durch die 1/O-Subsysteme ge- 
schleust wird, ist dieser Bereich der geeignete Platz, um die 
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Funktionen »abzufangen«. Die I/O-Subsysteme in OS/2 
sind, mit anderen Worten, vollständig durch Applikations- 
programme oder Systemerweiterungen ersetzbar. Die 
Struktur jedes I/O-Subsystems (siehe Abb. 3) enthält eine 
Router-Komponente und einen Satz Serviceroutinen. Wenn 
ein Programm (Applikation oder System) von einem der 
1/O-Subsysteme liest oder eines beschreibt, wird diese 
Anforderung vom Router verarbeitet und in den meisten 
Fällen an die vom System gestellte I/O-Serviceroutine wei- 
tergegeben. Für jede Subsystem-API wird von OS/2 eine 
Standard-Serviceroutine angeboten. 

Eine Systemerweiterung (entweder Teil der Applikation 
oder eines anderen Prozesses) kann sich selbst registrieren 
lassen, um irgendeine oder alle I/O-Subsystem-APlIs zu 
handhaben. Der Router sendet einfach die einzelnen API- 
Aufrufe an jene System-Serviceroutine oder jene Systemer- 
weiterung, die zur Verarbeitung registriert wurde. Im Zwei- 
felsfall gehen alle 1/O-Subsystemaufrufe an die Servicerou- 
tinen, die mit OS/2 angeboten werden. Wenn die Systemer- 
weiterung den API-Aufruf empfängt, kann sie eine der 
folgenden Aktionen ausführen: 
= die I/O-Anforderung verarbeiten; 
= die Anforderung prüfen und an die OS/2-Serviceroutine 

weitergeben (mit oder ohne Modifizierung der Applika- 

tionsdaten); 
= nichts tun und die Kontrolle an die Applikation zurück- 
geben (dadurch wird dann die Funktions-Anforderung 

»verschluckt«). 

Abb. 4 illustriert, wie eine Systemerweiterung sich selbst 
eintragen lassen kann, um einige der 1/O-Subsystem-Servi- 
ces zu handhaben. Beachten Sie, daß jeweils nur eine 
Systemerweiterung registriert werden kann, die alternative 
Subsystem-Services anbietet. OS/2 erlaubt keine Verket- 
tung von Erweiterungen. 


Sessions 


OS/2 implementiert mehrfache Anwender-Sessions. Eine 
Session ist ein Prozeß oder mehrere Prozesse, die zusam- 
men laufen und Tastatur, Videodisplay und die Maus 
gemeinsam nutzen. In den meisten Fällen entspricht eine 
Session einem Applikationsprogramm. Der OS/2-Anwen- 
der kann bis zu 12 gleichzeitig ablaufende Sessions starten. 

Der Begriff Session ist wichtig im Zusammenhang mit 
1/O-Subsystemen, da er einen logischen Zustand des Sub- 
systems definiert. Obwohl jeweils nur eine Version des Sub- 
systems in das System geladen wird, besitzt doch jede Ses- 
sion einen anderen Kontext. Jede Session verfügt mit ande- 
ren Worten über ihren eigenen Satz Datenbereiche, die den 
Status der Tastatur, des Videodisplays und der Maus defi- 
nieren. Wechselt der Anwender von Session zu Session, 
wird der Kontext des Devices wieder zurückgeladen. 

Das System unterhält im Fall der Video-Services für 
jede Session einen logischen Video-Buffer (LVB). Der LVB 
ist ein Abbild des Bildschirminhalts. OS/2-Programmierer 
greifen darauf über die Video-Subsystem-Aufrufe zu. 
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Abbildung 4: Ersetzen von OS/2-I/O-Subsystem-Funktionen. 


Diese Funktionsaufrufe stehen immer zur Verfügung, und 
eine Applikation kann so den Bildschirm sogar dann 
aktualisieren, wenn er sich in einer Hintergrund-Session 
befindet. 

Im Fall der Tastatur und der Maus unterhalten die 
OS/2-Subsysteme für jede Session eine eigene Queue. 
Wechselt der Anwender die Session, schaltet OS/2 zwi- 
schen den Input-Queues um. 

Abb. 5 illustriert, wie OS/2 mehrere Sessions unter- 
stützt. Die Ersetzbarkeit von Subsystem-Funktionen (die 
vorher beschrieben wurden) wird Session-weise durchge- 
führt. Verschiedene Systemerweiterungen in verschiedenen 
Sessions können zum Beispiel die 1/O-Subsystem-Services 
übernehmen. Eine Systemerweiterung kann zur Handha- 
bung von I/O-Anforderungen für seine Session nur sich 
selbst registrieren lassen. Da jedoch die Grund-Services in 
einem Dynamic-Link-Modul enthalten sind, können sie 
ersetzt werden (für alle Sessions), indem einfach die DLL- 
Datei ersetzt wird. 


Auswirkungen auf das Family-API 


Die meisten OS/2-Subsystem-Services sind im Family-API 
enthalten. So verbinden denn auch die API-Bindings, die 
mit Subsystem-I/O-Aufrufen verknüpft sind, die System- 
routinen mit dem Applikationsprogramm. Um denselben 
Grad an Leistung in der PC-DOS-Umgebung zu bieten, 
verwenden diese Bindings das System-BIOS nicht. 
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Abbildung 5: OS/2-Session. 


Das I/O-Subsystem-API ist also ein Satz Standard-I/O- 
Subroutinen. Wenn eine Family-Applikation unter PC-DOS 
läuft, führt der in den Bindings enthaltene Code die 1/O- 
Services durch. Läuft dieselbe Applikation unter OS/2 (im 
Protected-Mode), fallen die Bindings weg und die grund- 
legenden Subsystem-Services werden eingesetzt. 


Video-I/O-Subsystem-Services 


Die Video-I/O-Services (die insgesamt als VIO-API 
bezeichnet werden) sind ein Funktionensatz, äquivalent zu 
den BIOS-Video(INT10)-Routinen,. Die VIO-Services 
gehen jedoch über die BIOS-Einrichtungen hinaus, da sie 
Erweiterungen zur Manipulation von Zeichenstrings, Attri- 
buten und Zellen in einer funktionelleren Weise enthalten 
als die BIOS-Services, die sie ersetzen. Eine Zeichenzelle ist 
die Kombination eines Zeichens und seines Display-Attri- 
buts. 

Eine erwähnenswerte Ausnahme bilden die Grafikfunk- 
tionen (pixelorientiert), die von den VIO-APIs nicht unter- 
stützt werden. Das VIO-Subsystem unterstützt somit das 
Display nur im Textmodus. Obwohl VIO keine Grafik-Pri- 
mitive enthält, erlaubt es einer Applikation, Grafik-Display- 
Modes einzustellen. Wenn eine Applikation das Display auf 
Grafikmode einstellt, übernimmt sie die Verantwortung für 
die Handhabung des Displays. Diese Einschränkung ist 
jedoch nicht so ernst, wie es aussehen mag. Applikationen 
in der PC-DOS-Umgebung setzen fast nie die BIOS-Servi- 
ces ein, um einzelne Pixel des Bildschirms zu beschreiben. 
In PC-DOS werden Grafik-Services in der Regel von höhe- 
ren Grafik-Schnittstellen angeboten, zum Beispiel vom vir- 
tuellen Device-Interface (VDI) oder dem Grafik-Device- 
Interface (GDI). 

VIO bietet viele Stufen für den Display-Zugriff. Welche 
Technik verwendet werden sollte, hängt stark von den spe- 
zifischen Eigenschaften des Applikationsprogrammes ab. 
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Sequenz Beschreibung 

ESC[#;#H Cursor zu den Koordinaten (ROW;COL) 
bewegen 

ESC[#;#H Cursor zu den Koordinaten (COL;ROW) 
bewegen 

ESC[#A Cursor eine oder mehrere Zeilen nach oben 
bewegen 

ESC[#B Cursor eine oder mehrere Zeilen nach unten 
bewegen 

ESCI#C Cursor eine oder mehrere Spalten nach 
rechts bewegen 

ESC[#D Cursor eine oder mehrere Spalten nach links 
bewegen 

ESC[#;#R _ Cursorposition zurückgeben 

ESC[6n Device-Status zurückgeben 

ESCIs Cursorposition speichern 

ESCf[u Cursorposition wiederherstellen 

ESC[2 Display löschen 

ESCIK Löschen bis Zeilenende 

ESC[#;..;#m  Zeichenattribute setzen 

ESC[=#h Displaymode setzen 

ESC[=#1 Displaymode zurücksetzen 


ESC[#;.;#p Tastatur-Input erneut zuweisen 


Tabelle 1: ANSI-Escape-Sequenzen 


Virtueller TTY-Output 


Mit dem virtuellen TTY-Service des VIO erhalten Applika- 
tionen eine höhere Schnittstelle zum Bildschirm. Das VIO- 
TTY ähnelt in der Funktion dem auf Handle basierenden 
1/O, das vom Dateisystem angeboten wird. Wenn ein Appli- 
kationsprogramm diese Funktion verwendet, ist der Bild- 
schirm-Output nicht umlenkbar. Das Dateisystem verwen- 
det die VIO-TTY-Funktion für die Bildschirmausgabe. 

Im TTY-Mode werden Zeichen immer an der aktuellen 
Cursorposition geschrieben. Nachdem das Zeichen 
geschrieben wurde, rückt der Cursor um eine Position vor. 
Wenn das Zeichen in der letzten Position der Zeile ge- 
schrieben wurde, springt der Cursor auf den Anfang der 
nächsten Zeile. Die folgenden Spezialzeichen im Output- 
strom werden als Befehle und nicht als Daten behandelt: 
(13) Carriage-Return: Dadurch wird der Output auf der 

nächsten Zeile fortgesetzt. Ist der Output auf der 
letzten Zeile des Displays angelangt, rollt der Bild- 
schirm um eine Zeile nach oben. 

(10) Line-Feed: Hat dieselbe Wirkung wie Wagenrück- 
lauf. Folgt sie einem Wagenrücklauf, wird die Zei- 
lenschaltung ignoriert. 

(08) Backspace: Der Cursor bewegt sich um eine Position 
zurück (ohne zu löschen). 

(09) Tab: Der Cursor bewegt sich zum nächsten Tabula- 
torstopp. Tab-Stopps gibt es alle 8 Bytes. 

(07) Bell: Ein kurzer Ton erklingt. 
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Eine Applikation kann die Funktion VIO-TTY jederzeit 
einsetzen. Ist die Applikation nicht die aktuelle Vorder- 
grund-Session, wird der LVB der Session aktualisiert. 
Sobald der Anwender die Session wieder in den Vorder- 
grund bringt, werden die Daten korrekt dargestellt. 

Die Funktion VIO-TTY implementiert auch die ANSI- 
Escape-Sequenzen zur Cursorpositionierung, verbesserter 
Attributkontrolle und Bildschirm-Mode-Kontrolle (siehe 
Tabelle 1). Der ANSI-Mode kann mit einem VIO-API oder 
dem ANSI-Utility-Programm an- oder abgeschaltet werden. 


Operationen mit Zeichenstrings 


Auf der nächstniedrigeren Funktionsstufe enthält das VIO- 
Subsystem des OS/2 einen kompletten Satz von Zeichen- 
1/O-Services der unteren Ebene. Diese Services stellen, 
allerdings mit einigen Erweiterungen, jene Funktionen zur 
Verfügung, die in der PC-DOS-Umgebung vom BIOS- 
INT10 angeboten werden. Tabelle 2 vergleicht die BIOS- 
mit den VIO-Funktionen. Zu den signifikanten Unterschie- 
den gehören: die Fähigkeit, Zeichenstrings (mit oder ohne 
Attribute) aus mehreren Bytes schreiben zu können; die 
Fähigkeit, Zeichen, Attribute und Zellen-Strings lesen zu 
können, sowie vertikales Rollen. 

Die Applikationen können die Zeichenfunktionen 
genauso wie virtuelles TTY jederzeit einsetzen, Ist die Ses- 
sion im Hintergrund, werden Veränderungen in der LVB 
der Session durchgeführt. 

In fast allen Fällen können Sie textorientierte Applika- 
tionen ganz mit den VIO-Zeichenfunktionen implementie- 
ren. Die Leistung dieser Funktionen ist bedeutend besser 
als die der entsprechenden BIOS-Services. Die VIO-Routi- 
nen sind für den Display-Adapter im System optimiert. 
Wenn zum Beispiel mit dem CGA-Displayadapter gearbei- 
tet wird, verwenden die VIO-Funktionen sowohl horizon- 
tale als auch vertikale Retrace-Synchronisation zur Maxi- 
mierung des Video-Durchsatzes. 

Ein Applikationsprogramm ist vollständig unabhängig 
von der Hardware, wenn Zeichen-VIO-Funktionen verwen- 
det werden. Das VIO-Subsystem maskiert die Unterschiede 
zwischen den verschiedenen Display-Adaptern, die von 
OS/2 unterstützt werden (CGA, EGA, VGA etc.), und 
optimiert deren Leistung. 


Logischer Video-Buffer 


Applikationen können auch direkt auf den LVB zugreifen. 
Das VIO-Subsystem des OS/2 enthält ein API, das einem 
Programm direkte Adressierbarkeit seines LVB verleiht. 
Mit dieser Adresse können Programme direkt jeden Teil 
des logischen Bildschirms aktualisieren. Sobald die Aktuali- 
sierung geleistet worden ist, kann der wirkliche Bildschirm- 
Buffer mit einer einzigen »Show«-Operation aktualisiert 
werden. Diese Art des Video-I/O ist sehr nützlich bei 
Applikationen, die große Teile des Bildschirms aktualisie- 
ren. Wird der Bildschirm in großen Blöcken aktualisiert, 
wird die Video-Leistung noch weiter optimiert. 
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Abbildung 6: Zugriff auf den logischen Videobuffer. 


Abb. 6 verwendet das folgende Beispiel, um zu zeigen, wie 
Sie diese Technik beim Aktualisieren des Bildschirms 
einsetzen können: 

1. Die Applikation fordert vom VIO-Subsystem Zugriff auf 
die LVB an. Ein Selektor wird in der LDT der Applika- 
tion erzeugt, und der Selektor wird an das Programm 
zurückgegeben. 

2. Mit diesem Selektor aktualisiert die Applikation die 
LVB direkt, so, als ob er der wirkliche Video-Buffer 
wäre. Zu diesem Zeitpunkt werden die Änderungen 
jedoch nicht auf dem Bildschirm sichtbar. 

3. Nach Ausführung aller Aktualisierungen fordert die 
Applikation, daß die Änderungen auf dem »wirklichen« 
Bildschirm durchgeführt werden. Das VIO-Subsystem 
verwendet dann die Daten im LVB, um den physikali- 
schen Bildschirm-Buffer zu ändern. 


Der direkte Zugriff auf den LVB ist die Video-I/O- 
Funktion niedrigster Stufe, die noch Device-Unabhängigkeit 
bewahrt. Spezielle Device-Eigenschaften bleiben vor der 
Applikation verborgen. Dieser LVB-Zugriff ist äquivalent 
zu den INT-10-Unterfunktionen FE und FF, die von 
TopView in der PC-DOS-Umgebung angeboten werden. 

Da die Applikation mit einer logischen Darstellung des 
Displays arbeitet, können Aktualisierungen der LVB jeder- 
zeit (mit der Session im Vorder- oder Hintergrund) durch- 
geführt werden. Befindet sie sich im Vordergrund, aktuali- 
siert die SHOW-Operation den Bildschirm direkt. Befindet 
sie sich im Hintergrund, wird die Information einfach 
gespeichert, bis die Session zum Vordergrund zurückkehrt. 


Juli/August 1989 


Vorteile für MS Journal ..\ete-Abonennten: 
e Informationen aus erster Hand 

e Fachberichte über ausgereifte Applikationen 
e Umfangreiche Testberichte 

e Veröffentlichung von Leseartikeln 

e Neue Produkte 


e Viele Fragen und Antworten zur Technik 


Sichern Sie sich die MS Journal ..\etc auch weiterhin! Der Abo-Preis beträgt 
seit 1.1.1989 DM 36,— für 1 Jahr (12 Ausgaben) oder DM 64,- für 2 Jahre 
(24 Ausgaben). 


Vorteile für Microsoft System Journal Abonnenten: 
e Experten-Informationen 

Fragen und Antworten 

e Tips & Tricks 

oe Termine & Daten 

® 

® 


MS Journal ..\etc - BESTELLUNG 


Ja, ich bestelle die MS ..\etc. ab: 
U] für mich/uns DO für umseitigen Empfänger 
Für: DO) 1 Jahr (12 Ausgaben) zum Vorteilspreis von DM 36,— 
U] 2 Jahre (24 Ausgaben) zum Vorteilspreis von DM 64,— 
Postzustellung frei Haus. Vertriebskosten und Mehrwertsteuer sind im Vorteilspreis enthalten. 


(Name (bitte in Blockschrift) 
Vorname 
Straße und Hausnummer 


PLZ und Ort 


a 


Dieses Angebot gilt für die Bundesrepublik Deutschland und West-Berlin. 
Auslandspreise: Schweiz sfr 40,-, Österreich öS 280,— (für 1 Jahr) 
Schweiz sfr 64,—, Österreich öS 500,- (für 2 Jahre) 


Microsoft Sysrm jour. 
Disketten - Bestellun 


oecoe.seus—”a„—cz”ecs—...—u.aaaee.o:...7.»..,..:.—.%. oe...,.,— —, —AA—A 
f für 1 Jahr ( 6 Ausgaben) Schweiz sfr 230,-, Österreich öS 1 800,- 

Ja ’ ER System Journal + Diskette ab: für 2 Jahre (12 Ausgaben) Schweiz sfr 220,-, Österreich 6$ 3 300,-. 

[] Für 1Jahr (6 Ausgaben) zum Vorteilspreis von DM 230,- Auslandspreise für Diskettenbestellung 


u ya Einzeldiskette Schweizsfr 19,80 Österreich öS 150,— 
Ü für 2Jahre (12 Ausgaben) zum Vorteilspreisvon DM420,-.  fürl Jahr ( 6-Ausgaben) Schweizsfr 118,80 Österreich 6S 950, 


für 2 Jahre (12 Ausgaben) Schweiz sfr 220,— Österreich öS 1 700,— 


Information über Bücher & Software 
Tools & Routinen 


® USW., USW., USW. 


Sichern Sie sich die Microsoft System Journal zum Abo-Vorteilspreis von DM 115,— 
für 1 Jahr (6 Ausgaben), oder von DM 210,- für 2 Jahre (12 Ausgaben). 


ich bestelle nur die Diskette 


er m. [] Einzeidiskette je Ausgabe DM 19,80 Ja „ ich bestelle das Microsoft System Journal ab; 
Vorteile für Microsoft System Journal ie Ok Sie Für: 
Ü für2 Jahre (12 Ausgaben) DM 220, — U ı Jahr (6 Ausgaben) zum Vorteilspreis von DM 115,- 


Abonnenten mit Diskettenbestellung: 
e Listings auf Diskette zum Compilieren 


U] 2Jahre (12 Ausgaben) zum Vorteilspreis von DM 210,-. 


Postzustellung frei Haus. Vertriebskosten und Mehrwert- 


2 Nina (Ole Im ioakarhrit) steuer sind im Vorteilspreis enthalten. 
[un y chnelle Über. nahme in Pr. ogramme Dieses Angebot gilt nur für die Bundesrepublik Deutschland und 
Vorname West-Berlin. 
e lieferbar auf der derzeit am weitest verbreiteten Schweizer 119, Österreich 88 850- für Jahr ( 6 Ausgaben). 
1 5. a Straße und Hausnummer Schweiz sfr 210,- Österreich öS 1 600,- für 2 Jahre (12 Ausgaben). 
RYZ) ” Diskette 360 KB für IBM PC und Kompatible Das Abonnement verlängert sich automatisch um ein weiteres 
. j FHzmmon Jahr zu den dann gültigen Preisen, wenn es nicht acht Wochen vor 
Sichern Sie sich das Kombinationspaket der gedruckten Ausgabe ” Ablauf gekündigt wird. eo 
des Microsoft System Journal und der digitalisierten Daten auf Diskette Dieses Angebot gilt nur für die Bundesrepublik Deutschland und IChbezahle mein Abonnement: BR 
REN Ü sofort nach Erhalt der Rechnung, ed ae“ 
Auslandspreise: Microsoft System Journal + Diskette: Ü Durch Bankeinzug, ® RT 


MS Journal .\efe  Media-Informationen_| 


—TMARKETING PROJEKT 2000 
BERATUNG : PLANUNG - REALISIERUNG : VON MARKETING:PROJEKTEN 
MS Journal . - Informationen aus erster Hand 
„\elc - Fachberichte über ausgereifte Applikationen 
Besmseeeneee „ - umfangreiche Berichte über Tests und neue Produkte # 
- eine klar definierte Zielgruppe (Anwender, die 


MS Journal FE 
„\etc | Microsoft-Software im Einsatz haben) 


|- eine garantierte Leseranzahl, da nur Abo-Vertrieb 


U JA, bitte schicken Sie mir schnellstmöglich M$ Journal...\etc 
Media-Unterlagen zu. 


7)  JA,ich bin interessiert an Anzeigenschaltungen in MS Journal .. \etc. 
Rufen Sie mich bitte unter folgender Telefon-Nummer an : 


bietet für den Leser 


bietet für den Inserenten 


Name 


‚garantiert & 

MS Jour nal |- größtmögliche Anzeigen-Akzeptanz In einem : In Firma 
„\eftc | aktuellen, professionellen Redaktionsumfeld a 

—n a ZU Außerst attraktiven Anzeigen-Preisen 5 - Straße 


Überzeugen Sie sich ! 
Info unter 089/7 85 58 82 oder mit Antwortkarte &» 


PLZ /Ort 


Empfänger der Zeitschrift 


, Name (bitte in Blockschrift) 


Vorname 


Straße und Hausnummer 


PLZ und Ort 


Garantie 


Mir ist bekannt, daß ich diese Bestellung innerhalb 
einer Woche bei der Bestelladresse widerrufen 
kann. Zur Wahrung der Frist genügt die rechtzeiti- 


. ge Absendung meines Widerrufsschreibens. 
- Ich bestätige dies durch meine zweite Unterschrift. 


Datum/Unterschrift 


Einzugsermächtigung 


- Hiermit ermächtige ich Sie widerruflich, die von mir zu 


entrichtenden Zahlungen für bei Ihnen bestellte Artikel bei 
Fälligkeit zu Lasten meines 


Kontos Nr.: 


BLZ: 


Geldinstitut 


durch Lastschrift einzuziehen. Wenn mein Konto die erfor- 
derliche Deckung nicht aufweist, besteht seitens des konto- 
führenden Geldinstituts keine Verpflichtung zur Einlö- 
sung. 


Datum/Unterschrift 


Garantie 


Mir ist bekannt, daß ich diese Bestellung innerhalb 
einer Woche bei der Bestelladresse widerrufen 
kann. Zur Wahrung der Frist genügt die rechtzeiti- 
ge Absendung meines Widerrufsschreibens. 


Ich bestätige dies durch meine zweite Unterschrift. 


Datum/Unterschrift 


Absender: 


Jetzt zum Abo-Vorteilspreis bestellen! 


Vorsprung sichern »- | 
aus erster Hand 

informieren. 

MS Journal ..\ete 


im Jahresabonnement 
nur DM 36,- 
im 2-Jahresabonnement | 


u sr 


Antwort 


Druck- und Verlagshaus 
Alois Erdl KG 


Postfach 

D-8223 Trostberg 

Antwort Insider-Informationen für Programmierer, 
Softwareentwickler, Systemdesigner und er- 
fahrene Anwender von Microsoft-Software. 
Microsoft System Journal 
im Jahresabonnement ( 6 Ausgaben) zu DM 115,- 
im 2-Jahresabonnement (12 Ausgaben) zu DM 210,- 

Sy stem Journal Listings auf Diskette zum Compilieren oder 

Leserservice 7311 uch m! zur schnellen Übernahme in Programme. 

piskett® Lieferbar auf 5%”Disketten 360 KB für | 


IBM PC und Kompatible | 
zez>=r Ze227 Microsoft System Journal + Diskette | 


Postfach 6740 


D-8700 Würzburg im Jahresabonnement ( 6 Ausgaben) zu DM 230,- 
im 2-Jahresabonnement (12 Ausgaben) zu DM 420,- | 
Bitte mit 
0 Pfg. 
freimachen 
Antwort 
MARKETING PROJEKT 2000 GmbH 
Frau Janz 
Gottfried-Böhm-Ring 59 


D-8000 München 70 


BIOS VIO-API Beschreibung 

00 VioSetMode Displaymodus setzen 

01 VioSetCurType Cursor-Typ setzen 
VioGetCurType Cursor-Typ ausgeben 


Cursor-Position setzen 
Cursor-Position lesen 


02 VioSetCurPos 
03 VioGetCurPos 


04 Lichtgriffel-Position lesen 
(Lichtgriffel wird von VIO 
nicht unterstützt) 

05 Aktive Seite wählen 


(Mehrere Seiten werden von 
VIO nicht unterstützt) 

Seite aufwärtsrollen 

Seite abwärtsrollen 


06 VioScrollUp 
07 VioScrollDn 


VioScrollLf Seite nach links rollen 
VioScrollRt Seite nach rechts rollen 
08 VioReadCellStr Zelle lesen (VIO liest String) 
VioReadCharStr Zeichen lesen (VIO liest 
String) 
09 VioWrtCharStr Zelle an Cursor-Position 
schreiben 


VioWrtNCell Zelle wiederholen 

10 VioWrtCellStr Zeichen an Cursor-Position 

schreiben 
VioWrtNChar Zeichen wiederholen 
VioWrtNAttr Attribut wiederholen 

11 VioSetPal Farbpalette setzen 

12 Grafikpunkt schreiben 
(Grafik wird von VIO nicht 
unterstützt) 

13 Grafikpunkt lesen (Grafik 
wird von VIO nicht unter- 
stützt) 

14 VioWrtTTY TTY-String schreiben (ANSI 
in VIO enthalten) 

15 VIOGetMode Video-Status ausgeben 

1900  VioWrtCharStrAtt Zeichen-String schreiben 
(Mit demselben Attribut) 

1901  VioWrtCharStrAtt Zeichen-String + Cursor 
schreiben (Mit demselben 
Attribut) 

VioWrtCharStr Zeichen-String schreiben 
(Nur Zeichen, keine Attri- 
bute) 

1902 _ VioWrtCellStr Zell-String schreiben 

1903 _ VioWrtCellStr Zell-String + Cursor schrei- 


ben 


Tabelle 2: BIOS-INT 10- und VIO-Text-Funktionen 


Abhängig von den Eigenschaften der Applikation sollte 
entschieden werden, ob statt der VIO-Zeichenfunktionen 
der LVB direkt verwendet werden sollte. Eine Applikation, 
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die kleine Teile des Bildschirms aktualisiert, eignet sich am 
besten für die Zeichen-I/O-Funktionen. Umgekehrt lassen 
sich Aktualisierungen großer Blöcke am besten mit LVB- 
Manipulationen durchführen. VIO-Zeichenfunktionen und 
LVB-Aktualisierungen schließen sich nicht gegenseitig aus: 
Eine Applikation kann in verschiedenen Situationen wech- 
selweise beide einsetzen. 


Zugriff auf das physikalische Display 

Auf der untersten Stufe erteilt das VIO-Subsystem des 
OS/2 direkten Zugriff auf den physikalischen Display-Buf- 
fer. Da OS/2 ein Multitasking-System ist, müssen spezielle 
Vorkehrungen getroffen werden, um sicherzustellen, daß 
die Bildschirm-Ressource vernünftig geteilt wird. Das VIO- 
Subsystem enthält mehrere Mechanismen, die eingesetzt 
werden müssen, wenn ein Applikationsprogramm direkt 
Bildschirm-I/O durchführt. 

Beachten Sie, daß es in den meisten Fällen weder not- 
wendig noch erwünscht ist, ein Applikationsprogramm zu 
schreiben, das direkt Bildschirm-I/O durchführt. Die Lei- 
stung der Zeichen-VIO-Funktionen des OS/2 ist adäquat 
für fast jede Applikation. Reicht die Leistung nicht, kann 
Bildschirm-I/O durch direkte Anwendung der VIO-LVB 
optimiert werden. Der direkte Zugriff auf das Display sollte 
aber nur als letzte Rettung erwogen werden. In gewissen 
Fällen, wie zum Beispiel bei Grafik-Applikationen, ist phy- 
sikalischer Zugriff jedoch obligatorisch. 

Wenn eine Applikation das Display direkt beschreibt, 
muß es auch die physikalischen Eigenschaften des Bild- 
schirms kennen. Physikalischer Bildschirm-I/O wird des- 
halb als Device-abhängige Applikationsfunktion bezeichnet. 


Gemeinsame Nutzung des Display-Buffers 


Ähnlich wie Sie den LVB anfordern, setzen Sie ein speziel- 
les OS/2-API ein, um direkte Adressierbarkeit des physika- 
lischen Bildschirm-Buffers zu verlangen. Das VIO-Sub- 
system erzeugt einen LDT-Deskriptor, der den Display- 
Buffer abbildet und Ihrer Applikation einen Selektor für 
den Zugriff auf das Speichersegment gibt. Da im System 
jedoch nur ein wirklicher Bildschirm-Buffer vorhanden ist, 
kann der Selektor nur eingesetzt werden, während die 
Applikation im Vordergrund ist. Schaltet der Anwender die 
Session in den Hintergrund, wird der LDT-Deskriptor 
ungültig gemacht. Versucht das Programm, ihn in diesem 
Zustand zu benutzen, erzeugt die CPU einen General-Pro- 
tection-Fehler, und das Applikationsprogramm wird von 
OS/2 terminiert. Abb. 7 illustriert, wie mehrere Sessions 
den Display-Buffer gemeinsam nutzen. 


Synchronisation von Bildschirmzugriffen 


Es ist sehr wichtig, daß ein Programm nur dann auf das 
physikalische Display-Device zugreift, wenn es in der Vor- 
dergrund-Session ist. Zur Entscheidungshilfe, wann es 
sicher ist, den Bildschirm zu beschreiben, bietet OS/2 einen 
Display-Synchronisations-Service an. 
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Abbildung 7: Direktes Video-I/O. 


Jedesmal, wenn ein Programm physikalischen Bild- 
schirm-I/O ausführen möchte, fordert das Programm mit 
dem Aufruf VioScrLock Exklusivverwendung des Displays 
an. Befindet sich die Session im Hintergrund, wird das Pro- 
gramm solange unterbrochen, bis der Anwender wieder in 
den Vordergrund umschaltet, und zu dem Zeitpunkt wird 
die Bildschirm-LOCK-Funktion erfolgreich realisiert. 
Befindet sich das Display im LOCK-Zustand, erlaubt OS/2 
dem Anwender nicht, in eine andere Bildschirm-Session 
umzuschalten. Mit der Funktion VioScrUnlock zeigt das 
Programm an, wenn es mit dem Beschreiben des Bild- 
schirms fertig ist. Der Bildschirm kann also nur dann aktua- 
lisiert werden, wenn er sich im LOCK-Zustand befindet. 

Die Applikation ist zuständig für das Aufteilen großer 
Bildschirm-Aktualisierungen in kleinere Elemente, um 
sicherzustellen, daß der Session-Manager nicht für längere 
Zeitspannen ausgesperrt bleibt. 


Speichern und Wiederherstellen des Video-Status 


Für alle Applikationsprogramme, die in Textmodi laufen, 
speichert OS/2 den Bildschirm-Kontext automatisch und 
lädt ihn auch wieder zurück. Wenn jedoch das Display- 
Device in einen Grafikmodus eingestellt wird, wird das 
Applikationsprogramm für das Abspeichern des Display- 
Kontextes verantwortlich. 

Eine Spezialfunktion, VioSavRedrawWait, führt diese 
Aufgabe durch. Das Applikationsprogramm erzeugt einen 
speziellen Ausführungsthread, dessen einzige Aufgabe darin 
besteht, den Display-Kontext zu speichern und wieder 
zurück zu laden. Dieser Thread (er wird SAVEREDRAW- 
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VIO API Beschreibung 

VioRegister Alternative VIO-Routine(n) defi- 
nieren 

VioDeRegister Alternative VIO-Routine(n) löschen 

VioGetBuf Adresse des logischen Video-Buf- 
fers (LVB) holen 

VioShowBuf Physikalisches Display mit dem 
LVB auffrischen 

VioGetPhysBuf Adresse des physikalischen Video- 
Buffers holen 

VioScrLock Physikalischen Bildschirm für I/O 
sperren 

VioScrUnlock Sperre des physikalischen Bild- 
schirms lösen 

VioSavRedrawWait Thread für Save/Restore ausweisen 

VioSavRedrawUndo Letzten SavRedrawWait-Aufruf 
rückgängig machen 

VioPopUp Popup-Fenster einblenden 

VioEndPopUp Popup-Fenster entfernen 

VioGetANSI ANSI-Status holen 

VioSetANSI ANSI-Status setzen (ein oder aus) 

VioPrtSc Bildschirm drucken (äquivalent zu 
BIOS-INT5) 

VioPrtScToggle PrtSc-Zustand abfragen 

VioGetConfig Video-Konfiguration abfragen 

VioGetFont Aktuellen Zeichensatz abfragen 
(EGA, VGA) 

VioSetFont Video-Zeichensatz definieren 

VioGetCP Aktuelle Code-Page abfragen 

VioSetCP Code-Page definieren 


Tabelle 3: VTO-Funktionen. 


Thread genannt) gibt sich dem VIO-Subsystem durch die 
Ausgabe des Funktionsaufrufes SaveRedraw zu erkennen. 
Sobald der Aufruf ausgegeben wurde, unterbricht das 
System den Thread. Der SAVEDRAW-Thread wird unmit- 
telbar bevor der Status der Session von Vordergrund auf 
Hintergrund oder umgekehrt geändert wird, »aufgeweckt«. 
Ist der Thread »wach« geworden, prüft er einen Indikator, 
der dem Thread mitteilt, ob der Status des Bildschirms 
gespeichert oder wiederhergestellt werden soll. Der Thread 
führt dann die Save- oder Restore-Funktion durch und gibt 
den VioSavRedrawWait-Aufruf erneut aus. 

Der SAVEDRAW-Thread ist also eine von der Applika- 
tion aufgebotene Funktion, die den Zustand des Bild- 
schirms versteht und vom VIO-Subsystem aufgerufen wer- 
den kann, um den Inhalt des Bildschirms für die Applika- 
tion zu speichern oder wiederherzustellen. 


Video-Popups 


Mitunter müssen Hintergrund-Programme dringend mit 
dem Anwender kommunizieren. Es kann zum Beispiel sein, 
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daß ein Drucker-Spooler den Zustand »Kein Papier mehr« 
anzeigen möchte, oder daß ein Alarm-Programm eine 
Nachricht präsentieren muß. Diese Nachrichten sollten 
offensichtlich nicht warten, bis der Anwender zur richtigen 
Session wechselt. 

Für diese Situationen können Hintergrund-Programme 
eine spezielle VIO-Funktion VioPopUp aufrufen, um eine 
Nachricht auf dem Bildschirm darzustellen. Ein OS/2-Pop- 
up ist jedoch keine Mehrzweck-Funktion, da jeweils nur ein 
Popup aktiv sein kann. Verlangen mehrere Programme ein 
Popup, wird eines bedient und die anderen blockiert. Appli- 
kationen sollten die Anwendung dieser Einrichtung auf kri- 
tische Situationen beschränken, die Anwenderaktionen 
erfordern. 


Kontrolle des Videomodus 


Der Funktionsaufruf VioSetMode setzt die Display-Video- 
Modes. Das VIO-Subsystem unterstützt zwar nur Textope- 
rationen, Applikationen können jedoch den Aufruf dazu 
verwenden, alle vom Displayadapter unterstützten Video- 
Modes zu setzen. Dies schließt 40- und 80-Spalten-Text (mit 
oder ohne Farbe-Burst), einfarbigen Text und alle Grafik- 
modi ein. 

Wenn zwei Displays an die Maschine angeschlossen 
sind, wechselt das VIO-Subsystem zu dem Device, das den 
gewählten Mode am besten approximiert. Wenn zum Bei- 
spiel ein Monochrom- und ein CGA-Adapter installiert 
sind, aktiviert zum Setzen des MONO-Modus das mono- 
chrome Display und zum Setzen von 80-Zeilen-Farbtext das 
CGA-Display. 

Die Funktion VioGetMode wird eingesetzt, um den 
aktuellen Display-Mode zu erfragen. Tabelle 3 faßt die übri- 
gen VIO-Funktionen zusammen. 


Tastatur-I/O-Subsystem-Services 


Die Tastatur-I/O-Services, die als KBD-API bezeichnet 
werden, bilden einen Satz Funktionen, der äquivalent zu 
den BIOS-Tastatur(INT16)-Routinen ist. Zusätzlich umfaßt 
KBD eine Reihe von Erweiterungen zum Empfang von 
Zeichenstrings und zur Bestimmung der Umschalt-Zu- 
stände. Die KBD-Funktionen sind wie im Fall der VIO-Ser- 
vices in zwei logischen Stufen implementiert. 


Höhere KBD-Input-Services 


Wie im Fall des VIO-Subsystems enthält auch das KBD- 
Subsystem eine höhere Schnittstelle zur Tastatur. Die 
Funktion KbdStringIn ist das Input-Analogon zu den VIO- 
TTY-Services. Diese Funktion ist ähnlich dem vom Datei- 
system angebotenen, auf Handle basierenden I/O. Wenn 
ein Applikationsprogramm diese Funktion anwendet, ist der 
Input jedoch nicht umleitbar. Das Dateisystem verwendet 
die Funktion KbdStringIn, um Zeichen von der Tastatur zu 
lesen. 
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Praxis, Ausg. 4 
Wie mit Hilfe systermnaher Programmierung in C die Hard- und Software der 
MS-DOS-Computer noch effizienter genutzt werden kann, wird in dieser Ausgabe 
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us dem Inhalt: 
* Die Verwendung von Bios-Routinen in C-Programmen + Algorithmus zur First- 
Fourier-Transtormation # Einbinden von Assembler-Routinen inC « Aufbau und 
Steuerung einer O-Einsteckkarte mit Bauanleitung 


Best.-Nr. 0991, DMisir 28,—, ö$ 230,— 


C-Praxis für Experten, Ausg. 3 

Aus dem Inhalt: 

+ Tabellen sortieren # Multilisten und invertierte Organisation = Arbeiten mit 
hashadressierten Listen « Einführung in die Graphentheorie « Suchverfahren in 
Listen « Baumstrukturen « Bildschirmmasken erstellen » Mit UNIX in die Zukunft und 
vielen anderen Programmierbeispielen 
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Aus dem Inhalt: 
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Strukturen « Der C-Präprozessor « Wichtige Routinen « Arbeiten mit 
Synioxdiagrammen 

Best.-Nr. 0440, DMistr 28,—, 6$ 230,— 


C auf dem Amiga 

Amiga 500, Amiga 4000, Amiga 2000 

Aus dem Inhalt: 

* Für Einsteiger, Umsteiger und Aufsteiger « Das Betriebssystem richtig genutzt = 
C-Compiler Im Vergleich « Compilieren - gewußt wie! # Intuition: Screens, 
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Soundeffekte zum Selbermachen = DOS - Disk im Grift und viele Tips und Tricks 
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BIOS KBD-API Beschreibung 

00 KbdCharIn Nächstes ASCI-Zeichen 
lesen (Warte-Indikator einge- 
schaltet) 


01 KbdCharlIn Testen, ob Zeichen anliegt 


(Warte-Indikator ausgeschal- 


tet) 
KbdPeck 
02 KbdGetStatus Shift-Zustand liefern 
KbdCharIn 
KbdPeek 
- KbdPeek Zeichen anschauen (Ver- 
bleibt in der Input-Queue) 
- KbdFlushBuffer Input-Buffer löschen 
- KbdSetStatus Tastatur-Status setzen 
- KbdStringIn Zeichen-String lesen (ANSI- 
Sequenzen werden unter- 
stützt) 
Andere Funktionen 
KbdRegister Alternative KBD-Routine(n) 
definieren 
KbdDeRegister Alternative KBD-Routine(n) 
löschen 


Tabelle 4: BIOS-INT16 und OS/2-KBD-Funktionen. 


Eine Applikation kann den Aufruf KbdStringlIn jederzeit 
einsetzen. Ist das Programm gerade nicht im Vordergrund, 
wird der Thread blockiert und wartet solange, bis die Ses- 
sion in den Vordergrund kommt. 

Die Funktion KbdStringIn implementiert auch die Stan- 
dard-ANSI-Escape-Sequenzen für Input-Filterung (siche 
Tabelle I). Der ANSI-Mode wird mit einem VIO-API oder 
dem ANSI-Utility-Programm gesetzt. Im Zweifelsfall ist 
ANSI-Modus eingeschaltet. Beachten Sie, daß die ANSI- 
Sequenzen nur dann interpretiert werden, wenn der Input 
mit dieser Funktion (oder mit Dateisystem-Handle-Input) 
gelesen wird. 


Niedrigere KBD-Input-Services 


Das KBD-Subsystem unterstützt auch niedrigere Zeichen- 
1/O-Funktionen. Programme können diese Aufrufe einset- 
zen, um die Tastatur-Scan-Codes und Shift-Zustände zu 
prüfen, um den Input-Buffer zu löschen und um in die 
Input-Queue zu schauen, Diese Funktionen sind analog der 
BIOS-INT16-Schnittstelle in der PC-DOS-Umgebung. 
Tabelle 4 erläutert die Unterschiede zwischen den BIOS- 
Services und den niedrigen KBD-Funktionen. 


Maus-1/O-Subsystem-Services 


Das OS/2-Maus-Subsystem hat im Gegensatz zu Tastatur 
und Video kein direktes BIOS-Äquivalent. Dieses Sub- 
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MOU API Beschreibung 
MouRegister Alternative Routine(n) definieren 
MouDeRegister Alternative Routine(n) löschen 
MouOpen Subsystem für die Session öffnen 
MouClose Subsystem schließen 
MouFlushQue Ereignis-Queue löschen 
MouGetDevStatus _ Status-Flags des Zeiger-Device ab- 
fragen 
MouGetEventMask Ereignis-Maske abfragen 
MouGetHotKey System-Hot-Key abfragen 
MouGetNumButtons Anzahl der Tasten abfragen 
MouGetNumMickeys Anzahl »Mickeys« pro Zentimeter 
abfragen 
MouGetNumQueEl Status der Ereignis-Queue des Zei- 
ger-Devices abfragen 
MouGetPtrPos Aktuelle Koordinaten des Zeiger- 
Devices abfragen 
MouGetPtrShape Form des Zeigers abfragen 
MouGetScaleFact Skalierungsfaktoren abfragen 
MouReadEventQue Ereignis-Queue des Zeiger-Device 
lesen 
MouSetEventMask Ereignismaske setzen 
MouSetHotKey System-Hot-Key setzen 
MouSetPtrPos Aktuelle Zeigerposition setzen 
MouSetPtrShape Form des Zeigers setzen 


MouSetScaleFact Skalierungsfaktoren setzen 


Tabelle 5: OS/2-Maus-Subsystem-Funktionen 


system versieht Applikationen mit einer kompletten Band- 
breite an Services, die zur Verwaltung des Zeiger-Devices 
benötigt werden. Maus-I/O ist weder umleitbar, noch 
enthält es eine ANSI-Unterstützung. Tabelle 5 faßt die vom 
MOU-Subsystem angebotenen Funktionen zusammen. 


Zusammenfassung 


Die OS/2-Subsysteme erweitern das PC-DOS-I/O-Modell 
ganz erheblich. Diese Komponenten bieten alle Hochlei- 
stungs-Primitiva, die zur Erstellung der OS/2-Anwender- 
Schnittstelle erforderlich sind. Wichtige Punkte, die man im 
Gedächtnis haben sollte, sind: 

= das Subsystem-Modell; 

= Beziehung zwischen OS/2-Subsystem und PC-DOS- 
1/O-Modell; 

1/O-Subsystem-Struktur und -Komponenten; 

Ersetzung von Subsystem-Funktionen; 

OS/2-Sessions; 

Video(VIO)-, Tastatur(KBD)- und Maus(MOU)-I/O- 
Funktionen. Ed lacobucei 


Dieser Artikel ist ein Auszug aus dem Buch »Das OS/2- 
Buch« von Ed lacobucci, erschienen im McGraw-Hill Verlag, 
mit dessen freundlicher Genehmigung der Abdruck erfolgt. 
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Buchbesprechungen 


Computerbegriffe, Übersetzungshilfen, Marktübersichten: 
Nachschlagewerke über Computer und Software 


Die Flut nimmt kein Ende: In den letzten Wochen sind wie- 
der so viele interessante Bücher in der Redaktion einge- 
troffen, die wir leider nicht alle lesen, geschweige denn 
ausführlich zu besprechen können. Einige sollen jedoch 
zumindest mit kurzer Inhaltsangabe und bibliographischen 
Informationen vorgestellt werden. Mittlerweile haben sich 
eine ganze Reihe Nachschlagewerke angesammelt, denen 
wir diese Seite widmen wollen. Bei diesen Büchern geht es 
im wesentlichen um die Erläuterung von Computerbegrif- 
fen, um Übersetzungshilfen und um eine Marktübersicht 
der in Deutschland angebotenen PC-Software. 


Wörterbücher 


Die beiden vorgestellten Wörterbücher dienen hauptsäch- 
lich zur Übersetzung englischer Fachausdrücke. Aus der 
DDR kommen die beiden geschickt aufgeteilten Bände des 
»Fachwörterbuch Informatik«. Im ersten Band findet man 
neben den englischen Fachausdrücken die deutschen, fran- 
zösischen und russischen Übersetzungen. Will man nun 
aber umgekehrt übersetzen, nimmt man den zweiten, den 
Register-Band und bekommt dort unter dem gewünschten 
Begriff eine Kennung, bestehend aus einem Buchstaben und 
einer vierstelligen Zahl, mitgeteilt. Ausgerüstet mit dieser 
Kennung, kann man nun im ersten Band die englische, fran- 
zösische und russische Übersetzung in einer Zeile leicht 
auffinden. 

Bei der Auswahl der etwa 25.000 Fachwörter wurden die 
allgemeinen Grundlagen der Informatik und der Program- 
mierung, die Softwareentwicklung, die Hardwarekompo- 
nenten, die Systemzuverlässigkeit und Anwendungen der 
Informatik in der Industrie berücksichtigt. Nicht berück- 
sichtigt wurden allerdings Begriffe wie Errorlevel, Window 
oder gar Thread, die bekanntlich aus MS-DOS, Windows 
bzw. MS OS/2 stammen. 


Prof. Dr.-Ing. habil Erich Bürger (Hrsg.): »Fachwörterbuch 
Informatik«, Heidelberg, Hüthig Verlag; 1989; 2 Bände, 903 
Seiten; ISBN 3-7785-1586-1; DM 138,-. 


Mehr hardwareorientiert zeigt sich das sogenannte »Große 
IWT-Wörterbuch«, das sich an technische Autoren, Über- 
setzer, Informatiker und an Technik interessierte Laien 
richtet. Es enthält über 23.000 Begriffe der Elektronik und 
Mikroelektronik, ist klassisch gegliedert in einen englisch- 
deutschen sowie deutsch-englischen Teil. Die Zielsetzung 
dieses Werkes war es, den neuesten Stand der Terminologie 
am Sprachgebrauch der Praxis darzustellen - was im großen 
und ganzen auch gelungen ist. Allerdings werden z.B. 
neurale Netze (neuron network simulation) etwas einfallslos 
als Neuronen-Netzwerk-Simulation bezeichnet. 


Dorothee Jauß, Cipriano Villani: »Großes IWT-Wörterbuch 


der Elektronik und Mikroelektronik«, Vaterstetten, IWT Ver- 
lag, 1989; 661 Seiten; ISBN 3-88322-2 18-6; DM 78,-. 
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Computerbegriffe kurz erläutert 


Einer etwas anderen Spezies gehören die beiden nun fol- 
genden Bücher an. Sie erläutern die wichtigsten Computer- 
begriffe kurz und prägnant. Das nunmehr in der zehnten 
Auflage vorliegende »Mikrocomputerlexikon« wurde über- 
arbeitet und um aktuelle Begriffe erweitert. Das macht sich 
z.B. dadurch bemerkbar, das solche Fachausdrücke wie 
Semaphore oder Thread zu finden sind. Behandelt wird 
alles von den Grundbegriffen bis zu den neueren Anwen- 
dungen wie Desktop Publishing und C-Techniken. Außer- 
dem sind im Anhang noch ein englisch-deutsches Wörter- 
buch und diverse nützliche Tabellen zu finden. 


Helmut Kraus: »Mikrocomputerlexikon«, Düsseldorf: Sybex- 
Verlag, 1989; 315 Seiten; ISBN 3-88745-518-5; DM 14,80. 


Etwas ausführlicher werden die Begriffe im »Software- 
Lexikon« erläutert, das sich im Gegensatz zum oben vor- 
gestellten Titel jedoch ausschließlich mit der Software und 
im engeren Sinne mit der Programmierung beschäftigt. In 
über 1.000 Stichwörtern werden nicht nur die wichtigen Pro- 
grammiersprachen und die strukturierte Programmierung 
beschrieben, auch andere Themen wie die Qualitätsanfor- 
derungen an Software und die wichtigsten Normen kommen 
nicht zu kurz. 


Prof. Klaus W. Jamin: »Das Software-Lexikon«, Stuttgart: 
Taylorix-Fachverlag, 1988; 348 Seiten; ISBN 3-7992-0439-3; 
DM 56,-. 


Software-Marktübersicht 


Bevor Sie das Rad wieder neu erfinden oder sich vielleicht 
entschließen, ein »runderes« zu konstruieren, können Sie 
im »PC Softwarebuch ’89« nachschlagen. Hier finden Sie 
anhand des praktischen Registers vielleicht schon ein Pro- 
gramm mit den Leistungsmerkmalen, die Sie brauchen. 

Das Spektrum der vorgestellten Programme reicht von 
branchenbezogener und neutraler Software bis hin zu wis- 
senschaftlich-technischen Programmen, Systemsoftware 
sowie Lehr und Trainingsprogrammen. Die Programm- 
beschreibungen werden ergänzt durch Angaben wie z.B. 
Hardwarevoraussetzungen, Programmiersprache, Benutzer- 
führung, Service, Zahl der Installationen, Bezugsquelle und 
Preis. Die Register Programmart, Hardware, Anbieter und 
Programmnamen sorgen für einen schnellen Zugriff auf die 
gewünschten Informationen. 

Das Softwarebuch erscheint jährlich neu mit den 
aktuellen Informationen, die auf den Meldungen der 
Softwarehäuser basieren. 


»PC Softwarebuch ’89«, Haar: Markt & Technik Verlag, 1989; 
814 Seiten; ISBN 3-89090-751-2; DM 39,-. 
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Der 1. Microsoft System Workshop 


Zum »1. Microsoft System Workshop für Windows- und 
OS/2-Entwickler« lud die Microsoft am 18. April nach 
München. Rund 160 Entwickler aus der Bundesrepublik, 
Schweiz und Österreich kamen und tauschten in mehreren 
Arbeitsgruppen ihre Programmiererfahrungen aus. In 
Kleingruppen konnten die Systemköche einmal ohne inter- 
essierte Presse und ohne Öffentlichkeit ungestört Probleme 
beim objektorientierten Programmieren, Test und Debug- 
ging-Verfahren, Optimierungsverfahren, Interprozeßkom- 
munikation und LAN Manager Programmierung erörtern. 
K.P. Welch, Präsident der amerikanischen Eikon Systems 
und P. Weger, Leiter des Supports beim LAN-Spezialisten 
3COM referierten neben Experten der deutschen 
Microsoft-Niederlassung. Unter den Teilnehmern waren 
viele bekannte Namen. Kaum eines der bedeutenden 
Systemhäuser fehlte auf der Liste. Große Häuser wie Sie- 
mens, die sich schon längere Zeit intensiv mit der Entwick- 
lung von Windows- und OS/2-Anwendung befassen, rück- 
ten teilweise gleich mit halben Dutzendschaften an. Einig 
war man sich, daß dies nicht der letzte Workshop dieser Art 
gewesen sein wird. Einige Teilnehmer wollen sich regel- 
mäßig in informellen Arbeitsgruppen treffen. 


Word 5.0 für MS-DOS und MS OS/2 
angekündigt 


Nach vielen Gerüchten ist es nun endlich soweit: Die engli- 
sche Version 5.0 des Textverarbeitungsprogramms Micro- 
soft Word für MS-DOS und MS OS/2 wurde fertiggestellt. 
Die deutsche Fassung wird voraussichtlich im September 
dieses Jahres in den Handel kommen. 

Die Version 5.0 enthält gegenüber ihrem Vorgänger 
zahlreiche neue Funktionen, u.a.: 

u Unterstützung des Protected Mode von MS OS/2; 
» Preview-Funktion; 

» Spaltenverarbeitung auf dem Bildschirm; 

# erweiterte Dateiverwaltungsfunktionen. 

Da die Version 5.0 über die gleiche Menüführung ver- 
fügt wie Microsoft Word 4.0, ist ein Umstieg problemlos 
möglich. 

Trotz des erhöhten Leistungsumfangs wird der Preis von 
Microsoft Word 5.0 gleichbleiben und nach wie vor 
1.490 DM zzgl. MwSt (unverb. Preisempf.) betragen. Die 
Schulversion wird für 410 DM zzgl. MwSt angeboten. Der 
Update-Preis von Microsoft Word 4.0 auf die Version 5.0 
liegt bei 399 DM zzgl. MwSt. Für Anwender allerdings, die 
nach dem 1. Mai 1989 die deutsche Version 4.0 erworben 
haben bzw. erwerben, wird ein Update auf Microsoft Word 
5.0 (deutsch) zum Sonderpreis von 179 DM zzgl. MwSt 
angeboten, der bis zum 31. Dezember 1989 gewährt wird. 

Interessant ist eine Aktion, bei der Microsoft-Händler 
ab Juni 1989 eine begrenzte Stückzahl sogenannter »Micro- 
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soft Word 4.0 Sommerpakete« anbieten. Zum Preis von 
1.490 DM zzgl. MwSt »steckt« in diesem Paket neben Word 
4.0 ein Gutschein, mit dem man zusätzlich bei Microsoft 
wahlweise ein Booklet mit Druckformatvorlagen (inklusive 
Diskette) oder ein Bitstream/Word-Installationskit mit den 
Softfonts Swiss und Dutch für Laserdrucker und PostScript- 
Drucker erwerben kann. 


Microsoft Multiplan 4.0 ab sofort im Handel 


Ab sofort bietet Microsoft das Tabellenkalkulationspro- 
gramm Multiplan 4.0 für die beiden Betriebssysteme MS- 
DOS und MS OS/2 an. Die neue Version (Preis: 864 DM 
zzgl. MwSt.) zeichnet sich gegenüber der Vorversion durch 
eine Reihe weiterer Verbesserungen aus und stellt die erste 
große Standardanwendung von Microsoft für das neue 
Betriebssystem MS OS/2 dar. 

Anwender von Microsoft Multiplan 3.0 können für einen 
Aufpreis von 120 DM (inkl. MwSt.) bis einschließlich 
31.07.89 auf die neue 4.0 Version überwechseln. Danach gilt 
der Preis der jeweils aktuellen Preisliste. Die Update-Ver- 
sion ist beim Fachhandel oder direkt bei Microsoft gegen 
Einsendung der Originaldisketten und des Handbuchs 
erhältlich. 


Eigenschaften von Microsoft Multiplan 4.0 


Datenbank 

Um Listen besser auswerten zu können und nach bestimm- 
ten Informationen zu suchen, lassen sich mit Microsoft 
Multiplan 4.0 Tabellen oder Teile dieser Listen als Daten- 
bank organisieren. Mit Befehlen können Daten nach be- 
stimmten Kriterien gesucht und auf Wunsch in eine neue 
Datei extrahiert werden. Darüber hinaus bietet Microsoft 
Multiplan 4.0 statistische Funktionen für die Arbeit mit der 
Datenbank. 

MS OS/2-Unterstützung 

Multiplan 4.0 ist jetzt auch unter dem Betriebssystem MS 
OS/2 (im Protected Mode) ablauffähig. Multiplan kann 
also gleichzeitig mit anderen Anwendungsprogrammen aus- 
geführt oder mehrmals gestartet werden, um die verschie- 
densten Aufgaben zu bearbeiten. Diese Unterstützung der 
Multitasking-Eigenschaften führt zur optimalen Rechner- 
ausnutzung und Zeitersparnis. 

Verbesserte Feldformatierung 

Microsoft Multiplan 4.0 ermöglicht mit den Formatierungen 
»Fett«, »Kursiv« und »Unterstrichen« eine Hervorhebung 
von Zellen oder Bereichen von Tabellen. Damit können 
Modelle besser strukturiert und übersichtlicher gestaltet 
werden. Die Farbe von Daten in Feldern und Zahlenfor- 
mate können vom Wert der Zelle abhängig gemacht und 
wichtige Ergebnisse besonders hervorgehoben werden. 
Funktionsauswahl 

Multiplan 4.0 weist mehr als 30 neue Funktionen auf, dar- 
unter Datenbankfunktionen, finanzmathematische, mathe- 
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matische und statistische Funktionen, sowie Sonder- und 
Textfunktionen, die die Formelerstellung erleichtern. Sucht 
man den Namen einer bestimmten Funktion, kann man am 
Bildschirm in einer Liste aller Funktionen nachsehen und 
diesen in die Formel einfügen, ohne im Handbuch nach- 
zuschlagen. 

Makros 

Multiplan 4.0 weist mehrere neue Makrobefehle auf, die 
das Aus- und Einschalten der Menü- und Bildschirmaktua- 
lisierung ermöglichen und das Bearbeiten von Eingaben in 
Befehlsfeldern erleichtern. 

Ändern der Feldbreite 

Multiplan 4.0 ermöglicht die Verwendung von Richtungs- 
tasten zum Ändern der Feldbreiten im Menüpunkt »Format 
Breite der Spalten« und »Format Standard Breite der 
Spalten«. Mit jedem Tastendruck ändert sich die Spalten- 
breite am Bildschirm, so daß sie dort direkt überprüft wer- 
den kann. 

Kompatibilität mit alten Menüs 

Die Befehlsmenüs wurden in Multiplan 4.0 zum Teil geän- 
dert. Um trotzdem die unter Microsoft Multiplan 3.0 er- 
stellten Makros einsetzen zu können, läßt sich auf das Menü 
der Version 3.0 umschalten. 

Druckertreiber 

Mit Multiplan 4.0 können Tabellen ohne Eingabe von 
Druckersteuerzeichen jetzt einfach gestaltet und formatiert 
werden. Man wählt den gewünschten Druckertreiber (wie 
bei Microsoft Word), um eine Tabelle mit den Schriftarten 
und -größen zu versehen, die im Bildschirmmenü angeboten 
werden. 

Einstellen der Druckoptionen 

Die Ränder der zu druckenden Tabelle lassen sich in An- 
zahl der Zeichen (Ze), Zoll (In) oder Zentimeter (Cm) 
spezifizieren. 

Ordnen 

Es kann nach mehreren Zeilen oder Spalten geordnet wer- 
den. Jede spezifizierte Zeile bzw. Spalte wird als ein sepa- 
rater Sortierschlüssel behandelt, wobei die erste Zeile bzw. 
Spalte in der Liste die wichtigste ist. Mit diesem Befehl 
kann nach bis zu 20 Schlüsseln gleichzeitig sortiert werden. 
Änderungen zum Befehl »Übertragen Laden« 

Der Befehl »Übertragen Laden« ist jetzt kontextabhängig: 
d.h. Multiplan 4.0 lädt Tabellen und Dateien, die im Multi- 
plan-, SYLK- oder ASCII-Format gespeichert sind, auto- 
matisch in dem Format, das im Befehl »Übertragen Optio- 
nen« zuvor festgelegt wurde. 

Speichern eines Tabellenbereichs 

Teilbereiche einer Tabelle können durch Spezifizieren des 
Speicherbereichs im Befehl »Übertragen Optionen« gespei- 
chert werden, um z.B. eine schr große Datei in übersicht- 
lichere Tabellen zu splitten. 

Darstellung des Befehlsbereichs 

Die Farbe von Befehlen kann zur leichteren Unterschei- 
dung von Befehlsnamen und Optionen geändert werden. 


Juli/August 1989 


Neue Tools für OS/2 Presentation Manager 


Mit Beginn der Verfügbarkeit von OS/2 Version 1.1 
(Presentation Manager) bei IBM und führenden OEMs 
(NCR, Bull, Compaq u.a.) hat sich die Situation bei den 
Entwicklungssystemen, die bei Microsoft für OS/2 erhält- 
lich sind, gravierend geändert. Das Software Development 
Kit (SDK) und das Network Development Kit (NDK) sind 
nicht mehr lieferbar. SDK-Besitzer erhalten selbstverständ- 
lich noch das letzte Update auf die endgültige OS/2-Ver- 
sion 1.1 mit dem aktuellen LAN-Manager-Release. Alle im 
SDK enthaltenen Tools, Programmiersprachen und die 
Dokumentation können nunmehr getrennt geordert werden 
(C-Compiler, Microsoft Macro Assembler (MASM), 
Device Driver Kit (DDK), Windows SDK). Das endgültige 
OS/2 Programmer’s Reference Bd. 1-3 und das Buch 
»Programming the OS/2 Presentation Manager« von 
Charles Petzold werden ab Juli 1989 vom Vieweg-Verlag 
über den Buchhandel vertrieben. 

Das Betriebssystem selbst (OS/2 PM) müssen Ent- 
wickler ab sofort bei den Hardwarelieferanten beziehen, die 
die OS/2 PM-Version mittlerweile freigegeben haben. Mit 
den oben genannten vier Herstellern sind bereits etwa 0% 
aller PCs abgedeckt, die zur Entwicklung von OS/2-Appli- 
kationen benutzt werden. Auch der OS/2 LAN-Manager 
muß jetzt über OEMs (Netzwerklieferanten wie 3Com, 
Torus, Ungermann-Bass u.a.) bezogen werden. Der im 
NDK enthalten gewesene SQL-Server wird als Retail-Pro- 
dukt von Ashton-Tate vertrieben. 

Um Programmierer noch besser als bisher zu unterstüt- 
zen, gibt es von Microsoft ab Juni neue Programmierwerk- 
zeuge für den OS/2 Presentation Manager, die wir im fol- 
genden zusammenfassen wollen: 


Presentation Manager Toolkit 


Das OS/2 Presentation Manager Toolkit (PTK) Version 1.1 
ist der Nachfolger des OS/2 Programmer’s Toolkit Version 
1.0 und enthält: 

» Vier MS-Press-Bücher: Das »MS Press OS/2 Program- 
mer’s Reference Vol. 1-3« und »Programming the OS/2 
Presentation Manager« von Charles Petzold 

» PM SW-Tools (Icon Editor, Dialog Editor, Font Edi- 
tor...) 

# 2,5 Mbyte Sample Code 

» Dokumentation auch in Online-Form via QuickHelp. 
Das PTK 1.1 kostet 1080 DM zzgl. MwSt. Das Update 

von 1.0 kostet 440 DM zzgl. MwSt. 


Presentation Manager Softset 


Zusätzlich zum PTK gibt es als Untermenge davon ein Pro- 
dukt namens »Microsoft Presentation Manager Softset 1.1«. 

Es enthält ein Buch zur Beschreibung der mitgelieferten 
Tools, die übrigens mit den Tools des PTK (Icon Editor, 
Dialog Editor usw.) identisch sind. Zusätzlich sind 200 
Kbyte Beispielcode enthalten. In Verbindung mit einer 
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OS/2-Programmiersprache hat man damit alle Software, 
die zur Anwendungsprogrammierung für OS/2 notwendig 
ist. Gedacht ist das Softset als Begleitsoftware für die 
Microsoft Press-Bücher (3x Reference + Petzolds Buch), 
die auch unabhängig vom PTK bestellt werden können. Der 
Preis liegt bei 450 DM inkl. MwSt. 

Beide Produkte (PTK und Softset) sind sowohl auf 3 
1/2- als auch auf 5 1/4-Zoll-Disketten verfügbar. 

Ganz besonders empfehlenswert ist die CD ROM Pro- 
grammer’s Library, Version 1.1. Sie umfaßt nun die kom- 
plette PM-, LAN Man- und SOL Server-Dokumentation auf 
einer einzigen CD-ROM, dazu die gesamte Dokumentation 
zu allen OS/2-Compilern, dem Windows SDK, MS-DOS, 
der Microsoft Maus und der Intel-Hardware-Familie 
(80x86/88), und kommt mit einer Dreifach-Lizenz für 
Netzwerkbenutzer und OPTI-NET Software. Jede weitere 
Benutzung im Netzwerk kostet 120 DM. Der Preis beträgt 
845 DM inkl. MwSt. Der Update von Version 1.0 ist kosten- 
los. 


Programmers’s Library auf CD-ROM 
wesentlich erweitert 


Die Version 1.1 der Microsoft CD-ROM Programmers’s 
Library, die Microsoft in diesen Tagen vorstellte, wurde 
wesentlich erweitert: Auf einer einzigen Compact Disk ste- 
hen Ihnen damit insgesamt 72 Bücher und mehr als 26 
Mbyte an Beispielprogrammen zur Verfügung. Der Inhalt 
der CD wurde damit gegenüber der Vorgängerversion um 
mehr als 225% vergrößert. Darüber hinaus gibt es eine 
erweiterte Suchfunktion, mit der sowohl in einem speziellen 
Buch, als auch in allen in einem der Verzeichnisse enthalte- 
nen Bücher nach Informationen gesucht werden kann. 

Die Microsoft CD-ROM Programmer’s Library 1.1 ist 
die zeitgemäße Informationsquelle für den professionellen 
Programmierer in der MS-DOS- beziehungsweise in der 
OS/2-Welt. Sie beinhaltet umfassende Informationen über 
MS OS/2, Windows, den Microsoft LAN-Manager, MS- 
DOS, die Microsoft-Programmiersprachen C, Macro 
Assembler, Basic, Pascal und Fortran, sowie der PC-Hard- 
ware. Der OS/2-Teil wurde erweitert und enthält nun die 
MS OS/2-Handbücher für Software-Entwickler einschließ- 
lich der Programmierhandbücher zum Presentation Mana- 
ger. 

Der MS-DOS-Teil umfaßt auch Dokumentationen zur 
neuen Version 4.0 des Betriebssystems. Im Netzwerkteil 
finden Sie Dokumentationen über den Microsoft LAN- 
Manager sowie den Microsoft SQL-Server. Neben 13 Aus- 
gaben des Microsoft System Journals (US-Version) enthält 
die CD auch noch vier Intel-Programierhandbücher zu den 
Intel-Prozessoren 80286, 80386, 80287, 80387. Insgesamt elf 
Bücher aus dem Microsoft Press Verlag, darunter »The 
New Peter Norton Programmer’s Guide to the IBM PC and 
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PS/2« von Peter Norton und Richard Wilton, »Advanced 
OS/2 Programming« von Ray Duncan und »Programming 
the OS/2 Presentation Manager« von Charles Petzold. 

Mehr als 100.000 Querverweise erleichtern das Auffin- 
den sich gegenseitig ergänzender Informationen, auch wenn 
diese in ganz verschiedenen Kapiteln eines Buches zu fin- 
den sind. Markierungen, die jeder Benutzer selbst setzen 
und auch wieder entfernen kann, erleichtern das Erkennen 
genutzter Informationen. 

Um die Microsoft CD-ROM Programmer’s Library 
Version 1.1 nutzen zu können, ist ein IBM PC, XT, AT, 
PS/2 oder dazu kompatibler Personalcomputer, der mit 
MS-DOS, Version 3.1 oder höher, sowie 640 Kbyte RAM 
ausgestattet ist, nötig. Microsoft empfiehlt zusätzlich die 
Verwendung eines PCs mit einer Festplatte. Darüber hin- 
aus benötigt der Anwender ein CD-ROM-Laufwerk, das in 
der Lage ist, Compact Disks im Format ISO 9660 zu lesen 
und die Microsoft MS-DOS CD-ROM-Extension 2.0. Die- 
ses Programm muß vom Laufwerkhersteller auf das jewei- 
lige Laufwerk angepaßt sein und kann entsprechend nur 
über diesen Hersteller bezogen werden. 

Für den Einsatz in vernetzten Mehrplatzsystemen ist die 
Version 1.1 besonders kostengünstig. Obwohl der Preis 
gegenüber der Version 1.0 nur geringfügig angehoben 
wurde, beinhaltet die neue Version 1.1 (Preis: DM 845 zzgl. 
MwSt.) eine lizensierte Drei-Benutzer-Version von Opti- 
Net, die es maximal drei Anwendern gleichzeitig erlaubt, 
eine CD zu nutzen. 


Communications Server komplettiert die 
Betriebssystemumgebung MS OS/2 


Die mit dem Einsatz von Computern zusammenhängenden 
Investitionen und Kosten haben heute vielfach eine Größe 
erreicht, die eine bessere Nutzung der DV-Ressourcen for- 
dert. Ein wichtiger Schritt zur Nutzenoptimierung ist die 
Vernetzung von Arbeitsplatzcomputern durch lokale Netz- 
werke. In größeren Organisationen und Unternehmen be- 
steht jedoch die Notwendigkeit, PC-Netzwerke auch an 
Zentral- und Abteilungscomputer anzuschließen, um eine 
Gesamtvernetzung zu erreichen. 

Hierfür haben Microsoft und Digital Communications 
Associates (DCA) zwei neue Netzwerk-Produkte ent- 
wickelt: DCA/Microsoft Communications Server (Comm 
Server) und DCA/ Microsoft Communications Workstation 
(Comm Workstation). Beide Produkte unterstützen IBM- 
Protokolle und Programmierschnittstellen. Sie erweitern die 
Anschlußmöglichkeiten von PCs und lokalen Netzwerken 
hin zu Großbereichs-Netzwerken. 

Comm Server ist eine Systemsoftware innerhalb der 
Microsoft LAN-Manager-Familie. Mit ihr kann der Arbeits- 
platzcomputer mit IBM-Großcomputern und anderen 
EDV-Systemen kommunizieren. Wie die anderen Netz- 
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werkprogramme von Microsoft läuft auch der Comm Server 
unter MS OS/2 auf der Server-Station und unterstützt 
sowohl MS-DOS- als auch MS OS/2-PCs. 

Die Einzelbenutzer-Konfiguration Comm Workstation 
läuft auf einer Workstation unter Microsoft OS/2, wobei 
Arbeitsplatz- und Server-Funktionen quasi vereint sind. 

Comm Server und Comm Workstation bieten beide die 
wesentlichen Funktionen, die heute in einem WAN (Wide 
Area Network) benötigt werden, um mit komplexen Appli- 
kationen arbeiten zu können und um die nächste Genera- 
tion unternehmensweiter DV-Systeme mit Hilfe von 
Großbereichs-Netzwerken aufzubauen. Diese Funktionen 
und Merkmale umfassen: 


» 3270-Terminal-Emulation. 

# Drucker-Emulation sowie File-Transfer zwischen 
Arbeitsplatzcomputern und SNA-Großcomputern bzw. 
Applikationen auf Großcomputer-Basis. 

# IBM-kompatible Programmierschnittstellen für MS- 
DOS und MS OS/2, einschließlich der APPC-Pro- 
grammierschnittstelle mit LU 6.2 - zur Nutzung und 
Entwicklung von Peer-to-Peer-Applikationen, die mit 
SNA-Großcomputern, Minicomputern oder PCs kom- 
munizieren können - sowie EHLLAPI- und SRPI-Pro- 
grammierschnittstellen mit LU 2 - zum Einsatz und zur 
Entwicklung von Applikationen, die mit Systemen auf 
Mainframe-Basis kommunizieren können. 

» Eine breite Palette von Standard-Anschlußprotokoll- 
Optionen, einschließlich SDLC, DFT, 802.2 (Token 
Ring) und X.25/QLLC. 

» Offengelegte Schnittstellen-Spezifikationen für Treiber 
zur Unterstützung von Adapterkarten beliebiger Her- 
steller. 

» Net-View Interface. 

Mit dem Einsatz der neuen Netzwerk-Softwareprodukte 
von Microsoft und DCA (Digital Communications Asso- 
ciates) sind eine Reihe von Vorteilen verbunden, die sich 
durch höhere Effizienz und verringerte Kosten bemerkbar 
machen: 

» Geringerer Speicherbedarf und verminderte Verarbei- 
tungsanforderungen beim PC. 

» Besserer Einsatz der Host-Ressourcen durch variable 
Nutzung der Logical Units (LU). 

» Gemeinsame Nutzung der Adapterkarten durch alle 
Workstations. 

» Einfache Verwaltung des gesamten Netzes von einer 
beliebigen Workstation aus. 

» Einsatz sowohl von MS-DOS als auch MS OS/2 Work- 
stations. Bei sukzessiver Umstellung von MS-DOS auf 
MS OS/2 stehen von Anfang an alle Möglichkeiten des 
Comm Servers für sämtliche verbleibenden MS-DOS 
Workstations zur Verfügung. 

Die Version 1.0 des DCA/Microsoft Comm Servers 
wird im vierten Quartal 1989 für Endkunden verfügbar sein. 
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Desktop Presentation für den Apple Macintosh 
mit Microsoft PowerPoint Version 2.0 


Ab sofort liefert Microsoft die deutsche Version 2.0 von 
Microsoft PowerPoint, der führenden Software zur Erstel- 
lung von Präsentationsgrafiken für den Apple Macintosh, 
aus. 

Microsoft PowerPoint ist eine Synthese aus Textverar- 
beitung und Grafikprogramm, speziell entwickelt, um 
schnell und auf äußerst einfache Weise Präsentationsunter- 
lagen zu erstellen. Eine Beispielpräsentation verdeutlicht, 
wie schnell man mit PowerPoint ansprechende Vortrags- 
unterlagen erstellen kann: Nach dem Starten von Power- 
Point ist zuerst das »Master«, d.h. die Vorlage zu definie- 
ren. Diese Vorlage ist häufig ein Rahmen, der ein Firmen- 
logo beinhaltet oder den Namen des Präsentierenden. Der 
Rahmen kann in verschiedenen Formen und Strichstärken 
erstellt werden. Anschließend erfolgt die Präsentations- 
erstellung, das eigentliche Beschreiben der Folien. Dazu ist 
in Microsoft PowerPoint eine sehr komfortable Textverar- 
beitung integriert, die es erlaubt, unterschiedlichste Schrift- 
sätze in verschiedenen Schriftgrößen zu wählen. Selbstver- 
ständlich kann auch ein Zeilenlineal eingeblendet und kom- 
plexere Formatierungen mit unterschiedlichen Textanord- 
nungen vorgenommen werden. 

Die Textverarbeitung stellt dem Anwender darüber hin- 
aus einige Werkzeuge zur Verfügung, die die Arbeit 
wesentlich erleichtern. Dazu gehört eine Funktion »Suchen 
und Ersetzen« und für falsch geschriebene Wörter eine 
deutsche Rechtschreibhilfe mit 80.000 eingetragenen Begrif- 
fen. Die Datei, die diese Begriffe speichert, kann jederzeit 
mit häufig benötigten Wörtern ergänzt werden. 

Nachdem die gesamten Folien erfaßt wurden, kann die 
Präsentation mit Hilfe einer mitgelieferten Symbolbiblio- 
thek noch etwas »aufgelockert« werden. Dazu stehen in 
einer Datei einige Dutzend vorgefertigte Pfeile und Grafi- 
ken zur Verfügung. 

Microsoft PowerPoint bietet außerdem die Möglichkeit, 
Diagramme oder Grafiken, die mit anderen Programmen 
(z.B. Microsoft Excel) erstellt wurden, in die Folien zu 
übernehmen. Dies kann wichtig sein, wenn Zahlenmaterial 
wie Verkaufs- oder Umsatzstatistiken präsentiert werden 
sollen. 

Die »Slide Show«-Funktion von Microsoft PowerPoint 
ermöglicht einen Durchlauf aller erstellten Folien am Bild- 
schirm. Sollte der Benutzer dabei feststellen, daß eine 
andere Reihenfolge der Vortragsunterlagen günstiger wäre, 
kann die Umstellung ganz einfach mit einer der beiden 
Sortierfunktionen vorgenommen werden: PowerPoint zeigt 
wahlweise Titel oder Miniaturabbildungen der Folien, die 
dann beliebig verschoben werden können. 

Mit der Version 2.0 bietet Microsoft PowerPoint nun 
noch einige neue Features. Das wichtigste ist wohl die volle 
Farbunterstützung des Macintosh II. Dazu hat Microsoft in 
Kooperation mit dem größten Dienstleistungsunternehmen 
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für Präsentationslichtbilder, der Firma Genigraphics, ein 
Colormodul in PowerPoint integriert, das alle auf dem Mac 
II darstellbaren 16,8 Millionen Farben zur Verfügung stellt. 

Microsoft hat die Erfahrung von Genigraphics genutzt 
und PowerPoint so ausgelegt, daß der Anwender nach Wahl 
seiner Hintergrundfarbe automatisch jeweils acht Vor- 
schläge für die Vordergrundfarbe erhält. Natürlich lassen 
sich nach wie vor die Vorschläge »ablehnen« und eigene 
Farben anhand eines Farbenkreises generieren. 

Die Möglichkeiten einer individuellen farbigen Gestal- 
tung sind damit nahezu grenzenlos. Hier noch zwei Bei- 
spiele aus den umfangreichen neuen Leistungsmerkmalen 
von Microsoft PowerPoint: Der Hintergrund von Folien 
oder Dias läßt sich mit Microsoft PowerPoint 2.0 stufenlos 
schattieren und zwar von fast allen Richtungen aus. Eine 
zweite Neuerung ist die Möglichkeit, einfarbige Grafiken 
nachträglich zu kolorieren. Mit dem Befehl »Bild 
kolorieren« läßt sich jeder Grauton der Grafik durch eine 
Farbe ersetzen. 

Microsoft PowerPoint Version 2.0 ist ein spezielles 
Softwareprogramm für den Apple Macintosh und für die- 
jenigen, die hohe Anforderungen an die Erstellung einer 
perfekten Präsentation stellen. Die Version 2.0 von 
Microsoft PowerPoint kostet 1.297 DM (inkl. MwSt). 


Microsoft richtet Europazentrale in Paris ein 


Rund die Hälfte ihres gesamten Umsatzes (Geschäftsjahr 
1987/88: 590,8 Mio US$) tätigt die Microsoft Corp. gegen- 
wärtig bereits außerhalb der USA, wobei das Europa- 
Geschäft mit einem derzeitigen Anteil von über 30% zunch- 
mend an Bedeutung gewinnt. Eine Entwicklung, die das 
Unternehmen künftig weiter forcieren wird und der man 
jetzt mit der Etablierung einer Europazentrale in Paris 
Rechnung getragen hat. An die Spitze der europäischen 
Zentrale berief Microsoft in diesen Tagen Bernard Vergnes 
als Vice President Europe, der seit 1983 die französische 
Niederlassung des US-Softwarespezialisten führte. 

Wie sehr Microsoft die Entwicklung in Europa im Auge 
hat, unterstreichen auch die Berufungen von Jeremy Butler 
als Senior Vice President für das internationale und OEM- 
Geschäft sowie von Joachim Kempin als Vice President für 
OEM-Verkauf und Product Support-Services. Butler zeich- 
nete zuletzt als General Manager of European Sales ver- 
antwortlich. Joachim Kempin hat in der Bundesrepublik die 
starke deutsche Microsoft-Präsenz aufgebaut, ehe er 1987 
zur Muttergesellschaft nach Redmond wechselte. Christian 
Wedell, Geschäftsführer der Microsoft GmbH: »Besonders 
unsere Anwender werden von der Zusammenführung der 
Support-Aktivitäten auf weltweiter Ebene profitieren.« Die 
Verantwortung für die Microsoft-Aktivitäten in der BRD, 
Schweiz und Österreich verbleiben weiterhin bei der 
Microsoft GmbH, München-Unterschleißheim. 
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Siemens übernimmt SQLBase und 
SQLWindows und Gupta Technologies 


Gupta Technologies und die Siemens AG haben vereinbart, 
daß Siemens ab sofort Guptas SQLBase Server und SOL- 
Windows Software (MS Windows-Oberfläche) für Einplatz- 
systeme und vernetzte PC-Lösungen vermarkten wird. 
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Interaktive Programmierung mit SQLWindows 


Der SQLBase Server ermöglicht die Entwicklung von 
Datenbank-Anwendungen mit Multi-User-Eigenschaften 
auf PC-Netzen, die früher weit größere Systeme erforder- 
ten. Das Produkt, vorgestellt im Oktober 1986, ist derzeit 
der einzig verfügbare Datenbank-Server, der sowohl unter 
MS-DOS als auch unter OS/2 und in allen wichtigen PC 
Netzwerken läuft. Anwendungen, die mit SQLBase oder 
S$SQLWindows entwickelt wurden, lassen sich auf Einzel- 
platzsystemen genauso wie auf vernetzten PCs einsetzen. 
Gleichzeitig ermöglichen sie den Zugang zu IBMs Daten- 
bank DB2 und Großrechnern. 

Die Software von Gupta wird in die Comfoware-Pro- 
duktpalette (Vertrieb über SPI) von Siemens integriert, bei 
der unterschiedliche Anwendungsprogramme mit grafi- 
schen Bedieneroberflächen ein für den Benutzer außer- 
ordentlich komfortables Bürosystem auf PC-Basis bilden. 
Zusammen mit dem Hochleistungsnetz Comfonet/S ergibt 
sich mit dem SQLBase Server von Gupta Technologies ein 
leistungsfähiges System für verteilte Datenbank-Anwendun- 
gen in einem PC Netz. 

Gupta Technologies ist eines der führenden Unterneh- 
men im wachsenden Markt der netzwerkorientierten, unter- 
nehmensweiten Datenverarbeitung (cooperative proces- 
sing). Guptas direkte Vertriebspartner sind Fortune 1000 
Unternehmen, VARs und OEM-Kunden. Guptas Ver- 
triebsorganisation umfaßt neben eigenen Büros in den USA 
auch Vertragspartner in Europa; so verfügt Gupta über 
Distributoren in England, Frankreich, der Schweiz sowie 
der Bundesrepublik Deutschland. Die wichtigsten OEM- 
bzw. Distributionspartner sind Nokia Information Systems 
in Skandinavien und Mitsubishi Corporation in Japan. 
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MS LAN-Manager unter OS/2 im Powernetz 
von Schneider & Koch 


Der LAN-Manager von Microsoft feierte bei Schneider & 
Koch Premiere. Zum ersten Male zeigten die Netzwerker 
aus Karlsruhe auf der CeBIT ’89 die Implementierung des 
neuen LAN-Betriebssystems von Microsoft auf dem Hoch- 
leistungsnetzwerk SK-NET der breiten Öffentlichkeit. 

Nachdem die Testphase mit mehreren Pilotinstallatio- 
nen in Systemhäusern und Entwicklungsabteilungen großer 
Konzerne erfolgreich abgeschlossen wurde, stehen den 
OS/2-Entwicklern und -Anwendern lauffähige Systeme zur 
Verfügung. Zur Steigerung der Performance wurden neue 
OS/2- und DOS-Treiber von Schneider & Koch entwickelt 
und in das SK-LAN-Manager Serverkit implementiert. 

Als weitere Produktinnovation von Schneider & Koch 
wurde das von SCO und Microsoft entwickelte XENIX- 
NET auf den LAN-Manager im SK-NET adaptiert. Mit die- 
sem SK-XENIX Server-Interface ist es jetzt möglich, Rech- 
ner unter XENIX, OS/2 und DOS mit Hilfe des SK-LAN- 
Managers in einem Netzwerk zu vereinen. Somit stehen den 
unter dem SK-LAN-Manager laufenden PCs entfernte 
XENIX-Ressourcen ebenso zur Verfügung, wie normaler- 
weise entfernte Speicherkapazitäten oder Drucker auf ande- 
ren DOS- und OS/2-Maschinen. Aufgrund der bereits vor- 
handenen großen Anzahl von Applikationen unter XENIX, 
wird die XENIX/UNIX-Integration in ein zentrales Ether- 
net-LAN an Bedeutung gewinnen. 

Schneider & Koch sieht in der Kooperation mit 
Microsoft eine Möglichkeit, High Tech made in Germany 
innerhalb der OS/2-Welt auszubauen. Multikfunktionale 
Kommunikationsprotokolle werden die Connectivity in 
einem InterNet von Schneider & Koch enorm erweitern. 


3Com-Netzwerk jetzt auch mit SQL-Server 


Der kalifornische Netzwerk-Hersteller 3Com gibt die Frei- 
gabe der SOL-Server-Version von Ashton-Tate für 3Com- 
Netzwerke unter dem »3+Open LAN Manager« bekannt. 
Damit können 3+Open-Anwender auch komplexe Daten- 
bank-Probleme in einem PC-Netzwerk lösen. Anwendun- 
gen, wie Ticket-Reservierungen bei Fluglinien und Auf- 
trags-Abwicklung in größeren Unternehmen sind Beispiele 
dafür. 

Der SOL-Server ist eine relationale Datenbank, die von 
Ashton-Tate und Microsoft gemeinsam speziell für OS/2- 
Anwender entwickelt wurde. Seine Entstehung verdankt 
dieses Produkt nicht zuletzt den technischen Möglichkeiten, 
die der OS/2-LAN Manager in Form von APls 
(Application Program Interface) anbietet. In der offenen 
Netzwerk-Architektur, wie sie der »3+Open LAN Mana- 
ger« anbietet, verhält sich der SOL-Server, wie jeder andere 
Netzwerk-Dienst. Er nutzt dabei die Teilung der Aufgaben 
zwischen Server und Workstation. 


Juli/August 1989 


Der Vorteil für den Anwender liegt darin, daß praktisch 
von allen Workstations im Netzwerk gleichzeitig auf die 
gleichen Daten im Server zugegriffen werden kann. Zusätz- 
lich wird diese Netzwerk-Datenbank von den Möglichkeiten 
des erweiterten Datenschutzes und der leichteren Verwal- 
tung, wie sie der OS/2 LAN-Manager bietet, unterstützt. 


db-Vista III jetzt auch für MS-Windows 


Ab sofort ist db-Vista III, die Datenbank für C-Program- 
mierer, auch für MS-Windows erhältlich. Damit können C- 
Programmierer erstmals die Vorteile einer schnellen und 
flexiblen Datenbank auf Netzwerkbasis mit der Windows- 
Philosophie verbinden. db-Vista folgt mit seinem Release 
3.1 den Windows-Level-II-Regeln. Die mit Windows/db- 
Vista III entwickelte Applikation besteht aus kleinen Ein- 
zelprogrammen, die jeweils im Medium Memory Model 
kompiliert werden. Den einzelnen Modulen stehen jeweils 
volle 64 Kbyte im Datensegment zur Verfügung, da db- 
Vista III seinen eigenen Speicherbedarf aus dem Windows 
Global Memory deckt. Die einzelnen Module oder Tasks 
sind jeweils in einem eigenen Fenster darstellbar - in der 
Multiuser-Version kann so über mehrere Fenster auf die- 
selbe Datenbank zugegriffen werden. Der Vorteil liegt auf 
der Hand: Während in einem Fenster z.B. ein neuer Kunde 
eingegeben wird, kann in einem anderen Fenster eine Liste 
der bereits bestehenden Kunden angezeigt werden. Die mit 
db-Vista III entwickelten Applikationen sind voll in die 
Windows-Philosophie integrierbar und können leicht auf 
OS/2 und den Presentation Manager portiert werden. 

Durch den Swapping-Mechanismus von Windows gibt es 
keine Einschränkung der Applikationsgröße. db-Vista für 
Windows ist in einem Netzwerk oder auf Einzelrechnern 
lauffähig. Ein mitgelieferter NetBios-Emulator sorgt dafür, 
daß die Multiuser-Version von db-Vista auch in einer Um- 
gebung ohne Netzwerk lauffähig ist. 


Norton Utilities 4.5 in deutsch 


Der Markt & Technik Verlag kündigte für Anfang Juni die 
deutsche Version 4.5 der Norton Utilities an. Die neue 
Version der Norton Utilities ist weit mehr, als eine 
überarbeitete Version des Vorgängers. Durch den vollauto- 
matischen Disketten-Doktor und das Norton-Kontrollzen- 
trum setzt diese Utility-Sammlung neue Maßstäbe. Neben 
der extremen Leistungssteigerung gibt es vor allem für die 
Benutzeroberfläche einige Änderungen zu berichten. Trotz 
der reinen ASCII-Oberfläche hat man bei der Bedienung 
der neuen Utilities das Gefühl, daß hier die »Maus-Ziel- 
Klick-Macintosh-Oberfläche« Pate gestanden hat. Auf 
jeden Fall sind die neuen Norton Utilities die unerläßliche 
Hilfe für PC-Benutzer in allen Lebens- und Datenlagen. 
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Compaq mit neuem 33-MHz 80386-PC 
Compaq brachte unlängst drei Modelle des Compaq Desk- 
pro 386/33 auf den Markt. Er ist einer der derzeit weltweit 


leistungsfähigsten und erweiterbarsten Personalcomputer. 


Der Deskpro 386/33 hat sich äußerlich gegenüber seinem 25- 
MHz-Kollegen kaum verändert, doch bescheinigt ihm Com- 
paq 33% mehr Leistungsfähigkeit. 


Der Compaq Deskpro 386/33 ist für anspruchsvolle 
Anwendungen ausgelegt, wie z.B. Software-Entwicklung, 
CAD, Finanzanalysen sowie für den Einsatz als File-Server 
in Multi-User-Systemen. Dieser Computer basiert auf der 
Compaq Flex-Architektur und erreicht durch Kombination 
des fortschrittlichsten 386-Prozessors, des 33-MHz-80386 
von Intel, mit einem 64 Kbyte Cache-Speicher bei rechen- 
intensiven Anwendungen eine um 35 Prozent höhere Lei- 
stung als Personalcomputer mit 25 MHz Taktrate, 80386- 
Prozessor und Cache-Speicher. 

Der Compaq Deskpro 386/33 zeichnet sich durch platz- 
sparendes ergonomisches Design aus und bietet acht Erwei- 
terungs-Steckplätze sowie Raum für den Einbau von fünf 
Massenspeichern, die es ermöglichen, die interne Massen- 
speicherkapazität auf ein Maximum von 1,3 Gigabyte aufzu- 
rüsten - mehr als jeder andere derzeit erhältliche Desktop 
Personalcomputer. Ein 32-Bit-Steckplatz ermöglicht das 
Aufrüsten des Systems auf bis zu 16 Mbyte 32-Bit RAM. 

Der Compaq Deskpro 386/33 bietet kaum erreichte 
Verarbeitungsgeschwindigkeit und Leistung. Durch Kombi- 
nation der Compaq Flex-Architektur mit der höheren 
Taktrate des 33-MHz-Prozessors ergeben sich beim Com- 
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paq Dektop einige Leistungsvorteile gegenüber anderen 
Systemen. Die Flex-Architektur ermöglicht durch das 
»Concurrent-Bus-Prinzip«, bei dem Speicher- und Periphe- 
riebus gleichzeitig angesprochen werden, eine gleichmäßige 
Auslastung und Optimierung aller Subsysteme. 

Die Flex-Architektur ist mit einem 32-Bit-Speicherbus 
ausgestattet, der Speicherzugriffe bei voller Taktrate 
ermöglicht und 98 Prozent der Zeit mit Null Waitstates 
arbeitet. Ein separater Industriestandard-Erweiterungsbus 
für Peripheriegeräte ermöglicht die Verwendung von 8-Bit- 
und 16-Bit-Erweiterungsplatinen und Peripheriegeräten für 
PCs im Industriestandard. 

Der Compaq Deskpro 386/33 ist mit getrennten Sockeln 
für Coprozessoren ausgestattet, die den gleichzeitigen Ein- 
bau und Betrieb der neuen Coprozessoren 33-MHz Intel 
80387 und 33-MHz Weitek 3167 ermöglichen. Der 33-MHz 
Weitek 3167 Coprozessor ermöglicht bei besonders an- 
spruchsvollen wissenschaftlichen, konstruktionstechnischen 
und finanzanalytischen Anwendungen eine zwei- bis dreimal 
höhere Leistung als der 33-MHz-80387-Coprozessor. 

Durch Integration des VG-Controllers und der Stan- 
dard-Schnittstellen auf der Systemplatine bleiben Erweite- 
rungs-Steckplätze für andere Verwendungszwecke frei. Der 
Compaq Deskpro 386/33 bietet bessere Erweiterungsmög- 
lichkeiten und größere Speicherkapazität als andere 80386 
Dektop-PCs, einen 32-Bit Steckplatz für bis zu 16 Mbyte 
RAM, fünf 8-/16-Bit Erweiterungs-Steckplätze, einen 8-Bit 
Steckplatz und Raum für fünf interne Massenspeicher. 

Auf den Modellen des Compaq Deskpro 386/33 können 
Tausende von MS-DOS-, Microsoft Windwos/386- und 
UNIX/XENIX-Anwendungen sowie neue MS OS/2-An- 
wendungen für PC im Industriestandard ablaufen. 
Arbeitsspeicher 

Der Compaq Deskpro 386/33 verfügt über einen 32-Bit- 
Erweiterungs-Steckplatz, der ein Aufrüsten des Systems auf 
bis zu 16 MByte 32-Bit-RAM ermöglicht. Der 80385-Cache- 
Controller von Intel verwaltet den 64 Kbyte Cache-Spei- 
cher, der eine Zugriffszeit von 25 Nanosekunden hat und es 
dem System ermöglicht, bei fast allen Speicherzugriffen mit 
der vollen Taktrate von 33 MHz und über 98 Prozent der 
Aktivzeit mit Null Waitstates zu arbeiten. 

Der Compaq Expanded Memory Manager (das Dienst- 
programm CEMM) nutzt die Vorteile der Anwendungen, 
die der LIM/EMS-Spezifikation (Lotus/Intel/Microsoft 4.0 
Expanded Memory Specification) entsprechen und den Zu- 
griff auf Dateien im Speicherbereich jenseits der MS-DOS- 
Grenze von 640 Kbyte ermöglichen. 

Massenspeicher 

Der Compaq Deskpro 386/33 ermöglicht den internen 
Einbau von bis zu fünf Massenspeichern. Dadurch kann die 
interne Speicherkapazität auf bis zu 1,3 Gigabyte erweitert 
werden, mehr, als jeder andere Desktop Computer derzeit 
bieten kann. Alle Festplattenlaufwerke arbeiten mit Inter- 
leave-Faktor 1:1 und ermöglichen dadurch schnellen Daten- 
zugriff. Die 84-Mbyte-Festplatte hat eine mittlere Zugriffs- 
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zeit von weniger als 25 Millisekunden, die 320- und 650- 
Mbyte Festplatten haben eine mittlere Zugriffszeit von 
weniger als 18 Millisekunden. 

Video 

Der Compaq Deskpro 386/33 bietet integrierte VGA-Gra- 
fik, die zum Industrie-Standard voll kompatibel ist, jedoch 
aufgrund des 16-Bit-Datenpfades eine um 50 Prozent 
höhere Leistung erreichen soll als VGA-Grafik-Systeme 
anderer Hersteller. 


Grundausstattung 


Der Compaq Deskpro 386/33 ist standardmäßig mit einem 
VG-Controller und Schnittstellen für schnelle asynchrone 
Datenübertragung, Zeigegeräte, parallele Datenübertra- 
gung und Druckeranschluß sowie hochleistungsfähigen 
Festplattenlaufwerken ausgestattet. 

Ebenfalls zur Standardausrüstung gehören acht Erweite- 
rungs-Steckplätze voller Länge (sieben Steckplätze im Indu- 
strie-Standard und ein 32-Bit RAM Hochgeschwindigkeits- 
Steckplatz); 300-Watt-Netzteil mit automatischer Span- 
nungsumschaltung; die Dienstprogramme CEMM und 
CACHE sowie eine Garantie auf ein Jahr. 

Alle Modelle des Compaq Deskpro 386/33 sind stan- 
dardmäßig mit 2 Mbyte 32-Bit RAM und einem 5 1/4-Zoll 
Diskettenlaufwerk (1,2 Mbyte) ausgestattet. Das Modell 84 
verfügt über eine 84-Mbyte Festplatte halber Bauhöhe. Die 
Modelle 320 und 650 sind mit einem 320-Mbyte Festplat- 
tenlaufwerk halber Bauhöhe bzw. mit einem 650-Mbyte 
Festplattenlaufwerk voller Bauhöhe einschließlich zugehö- 
rigem 15-MHz ESDI-Controller ausgestattet. 


Scanner mit hoher Auflösung 


Die Scannerfamilie von Siemens wurde durch die Modelle 
High-Scan 600 und HighScan 800 erweitert. Ihre höhere 
Auflösung bringt insbesondere bei graphischen Anwendun- 
gen und bei der Schrifterkennung Vorteile. Mit den Model- 
len der HighScan-Familie will sich Siemens an die Spitze 
der Entwicklung bei professionellen Desk-Top-Scannern 
setzen. Mit der erreichten Auflösung lassen sich selbst 
reprofähige Vorlagen im Desktop-Publishing erstellen. 

Ein weiterer Einsatzschwerpunkt der hochauflösenden 
HighScan-Modelle ist die optische Zeichenerkennung 
(OCR). So lassen sich schon mit einer physikalischen Auf- 
lösung von 400 dpi etwa auch Petitschriften im 6-Punkt- 
Bereich ohne Einschränkungen verarbeiten, z.B. bei der 
lernfähigen OCR-Software OPTOPUS. Im Gegensatz zu 
300-dpi-Scannern werden auch bei Vorlagen mit Schrift- 
mischungen die mit HighScan eingelesenen Zeichen meist 
bereits nach einem einmaligen Lernvorgang sicher wieder- 
erkannt. Auch bei einer vortrainierten OCR-Software, wie 
z.B. RECOGNITA, zeigt sich, wie sehr es beim Einlesen 
auf eine möglichst hohe Auflösung ankommt. 
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AST baut 80486-Rechner 


AST Research Inc., Irvine, Kalifornien/USA, entwickelt 
bereits einen 80486er Rechner, der die bisherige 286 und 
386er Reihe als Topend erweitern soll. 

Als Haupteinsatzgebiet werden komplizierte und 
rechenintensive Anwendungen gesehen wie beispielsweise 
Modellentwicklung, Grafikerstellung, CAD/CAM oder 
Finanzanalysen. Von diesem Rechnertyp wird erwartet, daß 
er die nächste Dekade beherrschen wird. Inwieweit er eine 
direkte Konkurrenz zu Minicomputern sein wird, bleibt 
abzuwarten. AST wird diesen Rechner mit dem Intel- 
Microprozessor ausrüsten, und außerdem mit der neuen 
EISA-Bauweise (Erweiterte Industrie Standard Architek- 
tur) versehen. Die Auslieferung der neuen Computer ist für 
das zweite Quartal 1990 vorgesehen. 


Faxen - überall, wo es ein Telefon gibt 


Für das Fernkopieren unterwegs wurde auf der Basis des 
Siemens Minifax das Mobilfax HF2301M entwickelt. Als 
Koffergerät mit integriertem Akustikkoppler CTK Speedy- 
Fax 9600 ist das Mobilfax überall nutzbar, wo ein Telefon 
und ein Stromanschluß zur Verfügung steht, z.B. im Hotel- 
zimmer oder zu Hause. 


Mit der mobilen Kofferausrüstung kann man überall faxen, 
wo sich ein Telefon und eine Steckdose in der Nähe befinden. 


Mit dem HF 2301M - ein Gruppe-3-Fax - sind mit 9600 
bit/s Übertragungszeiten von unter einer halben Minute 
pro Normseite erzielbar. Werden Fotos detailgetreu in 16 
Graustufen umgesetzt, dauert es entsprechend länger. Im 
Stapelbetrieb können bis zu fünf Seiten automatisch an das 
angewählte Faxgerät kopiert oder als Lokalkopie gezogen 
werden. Für den Empfang von Fernkopien steht ein Papier- 
vorrat von rund 100 Seiten zur Verfügung. 
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Mit Microsoft-Seminaren sicher in die Zukunft 


Die ständige Leistungssteigerung in der Hard- und Soft- 
ware-Entwicklung läßt den Fachkräften der Industrie kaum 
eine Chance, die Möglichkeiten dieser Technologie in glei- 
cher Schnelligkeit umzusetzen. Dabei ist es von sehr großer 
Bedeutung, Arbeitsbereiche mit Hilfe der EDV zu rationa- 
lisieren. Um die Integration der EDV und damit eine Ar- 
beitserleichterung im betriebswirtschaftlichen Alltag zu er- 
reichen, wird Microsoft die Institut-Seminare in München 
und Düsseldorf fortsetzen, 

Diese Spezialseminare des Microsoft Instituts vermitteln 
in kleinen Gruppen intensiv all das, was zum Einstieg in die 
Programmentwicklung nötig ist. Modernste Trainings- 
methoden sowie PC-Demonstrationen und -Übungen sind 
selbstverständlich. Die Dozenten befassen sich auch im per- 
sönlichen Gespräch ausführlich mit den individuellen For- 
derungen und Problemen der Teilnehmer. So bekommen 
professionelle Entwickler durch professionelle Schulung die 
Möglichkeit, ihren hohen Wissenstand den neuen Gegeben- 
heiten anzupassen. Das Microsoft Institut bietet Seminare 
in drei Bereichen an: 


Systemsoftware 


Diese Seminare sind für PC-Software-Entwickler bestimmt. 
Die angebotenen Themen: 


Microsoft OS/2 

Microsoft Presentation Manager 
Microsoft Windows 

Microsoft LAN Manager 
Microsoft SOL Server 


Applikationen 


Diese Seminare sind in der ersten Linie für die Mitarbeiter 
des EDV-Benutzer-Services bestimmt. Die angebotenen 
Themen: 


MS-Word 

MS-Excel und MS-Excel Makro-Programmierung 
MS-Multiplan 

MS-Chart 


Informationsseminare 


Diese Seminare sind für die Mitarbeiter des EDV-Benut- 
zer-Service bestimmt. Die angebotenen Themen: 


a Einblick in Microsoft System-Software 
» LAN Manager und SOL Server 


Das Microsoft OS/2 Einführungs-Seminar 


Das zweitägige Seminar wendet sich an PC-Software-Ent- 
wickler, die Programmierkenntnisse in einer höheren Pro- 
grammiersprache wie C, Pascal, o.ä. besitzen. 
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Neben einem Überblick über den Intel 80286-Prozessor 
wird dann als Schwerpunkt dieses Seminars auf das Appli- 
cation Program Interface (API) eingegangen. In diesem 
Zusammenhang werden die Funktionen für Multitasking, 
Memory Management und Dynamic Linking ausführlich 
behandelt. Weitere Themen: Geräte- und Datei-Ein-/-Aus- 
gabe. Die in diesem Seminar gezeigten Programmbeispiele 
sind in Microsoft C geschrieben. 


Ort Datum Tag 

Düsseldorf 31.07./01.08.89  Mo./Di. 
04./05.09.89 Mo./Di. 

München 17./18.07.89 Mo./Di. 


Der Microsoft OS/2 Workshop 


Das dreitägige Seminar wendet sich an PC-Software-Ent- 
wickler, die Programmiererfahrungen in einer höheren, 
strukturierten Programmiersprache unter MS-DOS und C- 
Kenntnisse besitzen sowie das MS-OS/2-Einführungssemi- 
nar besucht haben. 

Die Teilnehmer lernen im Vortrag und praktischen 
Übungen am PC den komfortablen Editor zu nutzen, Fami- 
ly-API-Programme zu schreiben und Device-I/O-Routinen 
zu erstellen sowie Multitasking-Funktionen zu nutzen und 
eigene Dynamic-Link-Bibliotheken zu erstellen; außerdem 
können sie die erweiterten Speicherverwaltungsmöglichkei- 
ten des Intel 80286 nutzen und mit Hilfe des MS-OS/2 
Memory Managers programmieren. 


Ort Datum Tag 

Düsseldorf 02./03./04.08.89  Mi./Do./Fr. 
06./07./08.09.89  Mi./Do./Fr. 

München 19./20./21.07.89 Mi./Do./Fr. 


Das Microsoft Windows Einführungs-Seminar 


Das zweitägige Seminar wendet sich an PC-Software-Ent- 
wickler, die Programmierkenntnisse in einer höheren Pro- 
grammiersprache wie C, Pascal, o.ä. besitzen. 

Dieses Seminar behandelt die Microsoft Windows-Be- 
nutzerschnittstelle, die Microsoft Windows-Systemarchitek- 
tur, die Programmierwerkzeuge in der Praxis und Erstel- 
lung von Microsoft Windows-Programmen an Beispielen. 


Ort Datum Tag 

Düsseldorf 17./18.07.89 Mo./Di. 
21./22.08.89 Mo./Di. 

München 10./11.07.89 Mo./Di. 
04./05.09.89 Mo./Di. 
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Der Microsoft Windows Workshop 


Das dreitägige Seminar wendet sich an PC-Software-Ent- 
wickler, die Programmiererfahrungen in einer höheren, 
strukturierten Programmiersprache unter MS-DOS und C- 
Kenntnisse besitzen sowie das Microsoft Windows Einfüh- 
rungsseminar besucht haben. 

In diesem Seminar erwirbt der Teilnehmer durch prakti- 
sche Tätigkeit an einem PC die Fertigkeiten zur Program- 
mierung unter Microsoft Windows. Dazu werden verschie- 
dene Aufgaben gestellt und Übungen abgehalten. Als 
Hauptthemen dieses Seminars werden Übungen zu dem 
»Windowing«, der grafischen Programmierschnittstelle, den 
Benutzerschnittstellen und dem Dynamic Linking durchge- 
führt. 


Ort Datum Tag 

Düsseldorf 19./20./21.07.89  Mi./Do./Fr. 
23./24./25.0889 Mi./Do./Fr. 

München 12./13./14.07.89  Mi./Do./Fr. 
06./07./08.09.89  Mi./Do./Fr. 


Microsoft Presentation Manager 
Einführungs-Seminar 


Dieses zweitägige Seminar für Windows- und C-Program- 
mierer erläutert das Konzept des Presentation Managers 
und gibt einen Überblick über seine Programmierschnitt- 
stellen unf Fähigkeiten. 

Das Seminar behandelt die Benutzerschnittstelle des 
Presentation Managers, seine Architektur, die Program- 
mierwerkzeuge in der Praxis und die Erstellung von PM- 
Programmen an Beispielen. 


Ort Datum Tag 
Düsseldorf 25./26.09.89 Mo./Di. 
München 27./28.07.89 Do./Fr. 


Microsoft Presentation Manager Workshop 


Das dreitägige Seminar wendet sich an PC-Software-Ent- 
wickler, die Programmiererfahrungen in C und eventuell in 
Windows besitzen sowie das Microsoft Presentation Mana- 
ger Einführungsseminar besucht haben. 

In diesem Seminar erwirbt der Teilnehmer durch prakti- 
sche Tätigkeit an einem PC die Fertigkeiten zur Program- 
mierung unter dem Microsoft Presentation Manager. Als 
Hauptthemen dieses Seminars werden das Application Pro- 
gram Interface (API) des Presentation Managers bespro- 
chen. Dazu werden verschiedene Aufgaben gestellt und 
Übungen abgehalten: Windowing, Dynamic Linking Libra- 
ries USW. 
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Ort 
Düsseldorf 


Datum Tag 
27./28./29.09.89 Mi./Do./Fr. 


Microsoft LAN Manager Einführungs-Seminar 


Dieses zweitägige Seminar für Netzanwender und Netz- 
werk-Softwareentwickler mit Programmiererfahrung in C 
vermittelt das neue zukunftsweisende Programmierkonzept, 
um den MS OS/2 LAN Manager bedienen zu können. 

In diesem Seminar werden die neuen Konzepte des 
LAN Managers erörtert sowie neue und zukunftsweisende 
Programmiermethoden (hier ist die »distributed intelligence 
Method« zu nennen) vorgestellt. Weiterhin gibt das Semi- 
nar in seinem letzten Abschnitt eine Installations- und 
Bedienungsanleitung für den LAN Manager und vermittelt 
so einen »roten Faden« für den Netzwerkanwender. 


Ort Datum Tag 

Düsseldorf 10./11.07.89 Mo./Di. 
28./29.08.89 Mo./Di. 

München 03./04.07.89 Mo./Di. 


Microsoft LAN Manager Worksop 


Dieses dreitägige Seminar für PC-Softwareentwickler mit 
Programmiererfahrung in C, die am LAN Manager Einfüh- 
rungsseminar teilgenommen haben, vermittelt die Fähigkeit 
zum Schreiben von Programmen, die die grundlegenden 
Bestandteile des Microsoft LAN Managers benutzen. 

Der Schwerpunkt dieses Seminars liegt auf der Darstel- 
lung des API des LAN Managers. Themengebiete wie 
»Named Pipes«, »Mailslots«, »Server-Client-Konzept« usw. 
werden mit Hilfe von Übungen und praktischen Program- 
mierbeispielen erläutert. 


Ort Datum Tag 

Düsseldorf 12./13./14.07.89 Mi./Do./Fr. 
30./31.8./1.9.89  Mi./Do./Fr. 

München 05./06./07.07.89  Mi./Do./Fr. 


Microsoft SQL Server Einführungs-Seminar 


Dieses zweitägige Seminar für PC-Softwarcentwickler 
erläutert die Struktur und das Konzept des Microsoft SOL 
Server. Kenntnisse von MS OS/2 und dem MS LAN Mana- 
ger sollten vorhanden sein, SOL- und C-Kenntnisse sind 
von Vorteil. Das Seminar gibt einen Überblick über die 
Struktur und den Aufbau des Microsoft SOL Servers. 
Neben der Administration des Systems werden Funk- 
tionsweise und Einsatzgebiete des SQL Servers behandelt. 
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Ort Datum Tag 
München 25./26.09.89 Mo./Di. 
Microsoft SQL Server Worksop 


Dieses dreitägige Seminar für PC-Softwareentwickler mit 
Kenntnissen in C und SQL, die am Einführungsseminar und 
Workshop für OS/2 und den LAN Manager teilgenommen 
haben, vermittelt die Fähigkeit zum Schreiben von Pro- 
grammen, die die Funktionen des Microsoft SQL Servers 
benutzen. 

Der Schwerpunkt dieses Seminars liegt neben der 
Installation und Administration des Systems auf der aus- 
führlichen Erläuterung der DB-Library, der Programmier- 
schnittstelle des Systems. Die Methoden zur Programmie- 
rung werden mit Hilfe von Übungen und praktischen Pro- 
grammierbeispielen veranschaulicht. 


Ort 
München 


Datum 
27./28./29.09.89 Mi./Do./Fr. 


Tag 


Microsoft LAN Manager und SQL Server 
Informationsseminare 


Dieses eintägige Informationsseminar wendet sich an Ver- 
triebs- und Supportmitarbeiter sowie Entscheidungsträger, 
die Gerätekonfigurationen für Arbeitsgruppen festlegen. 

Die Teilnehmer gewinnen einen Überblick über die 
Architektur des Client-Server-Modells und die darin ange- 
legten neuen Möglichkeiten für die Gruppenarbeit in einem 
Netz durch gemeinsamen Zugriff auf eine zentrale Daten- 
bank. 

Dargelegt wird, was den LAN Manager von einem her- 
kömmlichen Netz unterscheidet und welche Vorteile für 
den Anwender damit verbunden sind. 

Die neuartige Architektur des SOL-Servers wird erläu- 
tert und welche zum Teil einmaligen, neuen Möglichkeiten 
sich in Hinsicht auf die Sicherheit, Datenintegrität, Trans- 
aktionen und Performance als Plattform für eigene Anwen- 
dungen und Verfügbarkeit ergeben. Schließlich werden die 
Oberflächen des LAN-Managers und des SQL-Servers er- 
klärt und an Beispielen gezeigt, wie man mit dem System 
arbeitet und welche komplexen Abfragen SOL ermöglicht. 


Ort Datum Tag 
Düsseldorf 22.05.89 Mo. 
München 21.06.89 Mi. 
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Microsoft Excel Makro-Programmierung 


Dieses dreitägige Seminar wendet sich an PC-Software- 
Entwickler, die mit Microsoft Excel schon einigermaßen 
vertraut sind. j 

Das Seminar gibt anfangs einen grundsätzlichen Über- 
blick über Microsoft Excel, der für das Verständnis der 
Makroprogrammierung nötig ist. Durch einfachere Ein- 
zelbeispiele wird der Teilnehmer zunächst mit der Makro- 
programmierung vertraut gemacht. Es folgt der Einstieg in 
komplexe Problemlösungen mit Makros, in denen u.a. 
sowohl selbstdefinierte Menüs und Dialogboxen als auch 
Funktions- und Befehlsmakros eingebunden sind. Weiterhin 
geht das Seminar auf die Microsoft Excel-Programmierum- 
gebung ein, wobei auf die Möglichkeiten hingewiesen wird, 
Informationen aus anderer Software mit Makros zu verar- 
beiten (Datev Datensätze) und wie mit Hilfe von Makro- 
befehlen die DDE-Schnittstelle von Microsoft Windows 
genutzt werden kann. 


Ort Datum Tag 

Düsseldorf 07./08./09.08.89 Mo./Di./Mi. 
12./13./14.09.89  Di./Mi./Do. 

München 24./25./26.07.89 Mo./Di./Mi. 
20./21./22.09.89  Mi./Do./Fr. 


MS-DOS Systemprogrammier-Seminar 
für Entwickler 


Die Firma Kontron veranstaltet in seinem Schulungscenter 
in Eching vom 26. bis 30. Juni ’89 einen 4-tägigen DOS- 
Systemprogrammier-Workshop. Es wird die interne Struk- 
tur des weitverbreiteten Betriebssystems MS-DOS behan- 
delt. Neben Themen wie 

» ROM-BIOS und BIOS-Aufrufe, 

DOS-Funktionsaufrufe, 

Kommando-Interpreter, 

Dateiverwaltung, 

Speicherresidente Programme etc. 

wird besonderes Augenmerk auf den Aufbau eines Trei- 
bers gelegt. Die Unterschiede zwischen den verschiedenen 
DOS-Versionen werden aufgezeigt. Dieser Workshop ist 
für den Personenkreis interessant, der Programme an das 
Betriebssystem MS-DOS anpassen muß, bzw. Programme 
für eine MS-DOS-Umgebung entwickelt. Zur Vertiefung 
des Stoffes steht für je zwei Teilnehmer ein AT-kompatibler 
Rechner zur Verfügung. 
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SAA-Benutzeroberfläche in € 


Eine komfortable Benutzeroberfläche in 


Teil 4): 


Eine Help-Engine für Ihre SAA-Applikationen 


Der elektronische Ratgeber, das Handbuch im 
Rechner - jederzeit auf Knopfdruck verfügbar - 
zählt nicht erst seit der Veröffentlichung des 
SAA-Standards zu den Leistungsmerkmalen, an 
denen sich jede PC-Applikation messen lassen 
muß. Da sich viele Programmierer bisher jedoch 
von der Komplexität eines solchen Hilfe-Moduls 
abschrecken ließen, möchten wir Ihnen im Rah- 
men dieser Folge unserer SAA-Serie eine univer- 
selle Help-Engine vorstellen, die auf einfachste 
Art und Weise in jede Applikation eingebunden 
werden kann. 


Proportional mit der steigenden Leistungsfähigkeit moder- 
ner PC-Applikationen ist auch deren Komplexität gewach- 
sen und da der typische PC-Anwender heute mehrere Stan- 
dard-Applikationen in seiner täglichen Arbeit einsetzt, kann 
ihm wohl kaum zugemutet werden, daß er alle Befehle, 
Optionen und Tastenkombinationen der verschiedenen 
Applikationen jederzeit im Kopf hat. Oft hilft da nur ein 
Blick in das Benutzerhandbuch weiter, doch lassen sich die 
benötigten Informationen dort in der Regel nur sehr schwer 
und unter großem Zeitaufwand finden. Aus diesem Pro- 
blemfeld heraus wurde die Idee des elektronischen Hand- 
buchs - einer On-Line-Hilfe direkt am Bildschirm - gebo- 
ren. Das Handbuch im Rechner allein ist jedoch noch nicht 
der Schlüssel zum Problem, wenn man sich auch innerhalb 
dieses Handbuchs erst mühsam zur benötigten Information 
vorarbeiten muß. Effizient wird die Arbeit mit einem sol- 
chen Handbuch nämlich erst dann, wenn man es mit einem 
gewissen Grad an Intelligenz versieht und es dadurch in die 
Lage versetzt, die aktuelle Situation, in der sich der Anwen- 
der befindet, zu erkennen. Dadurch nämlich kann es dem 
Anwender gezielt Informationen anbieten, die ihm in seiner 
augenblicklichen Situation weiterhelfen. 

Um dies anhand einer konkreten Situation deutlich zu 
machen: Wenn sich der Anwender beispielsweise innerhalb 
einer Eingabemaske befindet und über die festgelegte Help- 
Taste Hilfe anfordert, so ist er bestimmt nicht an Informa- 
tionen über die verschiedenen Programmbefehle oder die 
grundsätzliche Funktionsweise des Programms interessiert. 
Vielmehr ist ein Bezug zum aktuellen Kontext, also zu sei- 
ner augenblicklichen Situation innerhalb der Eingabemaske 
zu vermuten. Angeboten werden sollten ihm deshalb Infor- 
mationen über die allgemeine Bedeutung der Eingabe- 
maske, die spezielle Bedeutung der einzelnen Felder und 
Informationen über die Editierung der Maske, d.h. über das 
Wechseln zwischen den einzelnen Feldern, der Datenein- 
gabe innerhalb dieser Felder etc. Erst dieser Bezug zum 
aktuellen Kontext, dieses kontextsensitive Verhalten, ver- 
leiht einem Hilfe-System seine besondere Benutzerfreund- 
lichkeit. 
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Bild 1: Das Demo-Programm HLPDEMO.C verdeutlicht die 
Arbeit mit der Help-Engine. 


Ein kontextsensitives Help-System 


Um in jeder Situation den passenden Hilfetext parat zu 
haben, sieht die hier vorgestellte Help-Engine die Unter- 
teilung der Hilfe-Informationen in viele kleine Hilfetexte 
vor, die jeweils mit einer individuellen Kennummer zwi- 
schen 1 und 32.000 versehen werden. Da ein Hilfetext inner- 
halb einer SAA-Applikation jederzeit durch Betätigung der 
Taste [F1) abgerufen werden kann, empfiehlt sich die Imple- 
mentierung einer Help-Routine, die grundsätzlich bei der 
Betätigung dieser Taste aufgerufen wird. Das Tastatur- und 
Mausmodul, das in der zweiten Folge dieser Serie vorge- 
stellt wurde, unterstützt die Implementierung einer solchen 
Routine durch die Funktion KbdSetFkt(). Wird diese 
Funktion am Anfang Ihrer Applikation etwa folgender- 
maßen aufgerufen: 


KbdSetfkt( Fi, HelpFkt ); 


Dann wird die Funktion HelpFkt( ) mit jeder Betäti- 
gung der Taste aufgerufen. Damit HelpFkt() einen 
kontextbezogenen Hilfetext auf den Bildschirm holen kann, 
sollte Ihre Applikation über eine globale Variable verfügen, 
in die die einzelnen Programmteile jeweils die Nummer des 
ihnen zugeordneten Hilfetexts eintragen. 

Beachten Sie bitte auch, daß innerhalb einer SAA- 
Applikation jedes Hauptmenü und jedes der zugehörigen 
Untermenüs über einen individuellen Hilfetext verfügen 
sollte. Während dieser Hilfetext im Falle eines Hauptmenüs 
nur kurz die Aufgabe dieses Menüpunktes und die Bedeu- 
tung der einzelnen Untermenüs beschreibt, müssen die 
Hilfetexte zu den einzelnen Untermenüs ganz genau auf die 
Bedeutung des jeweiligen Menüs eingehen. Damit Ihre 
HelpFkt( ) erkennen kann, ob sich der Anwender inner- 
halb des Pull-Down-Menüs befindet und wenn ja, welches 
der Menüs der Menü-Cursor gerade überdeckt, lädt das 
Menü-Modul (aus der dritten Folge dieser Serie) die Kenn- 
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nummer des aktuellen Menüs jeweils in die globale Varia- 
ble aktmen, Mit Hilfe eines Vektors, der die Zuordnungen 
zwischen Menü- und Hilfetextnummern enthält, können Sie 
dann leicht den zugehörigen Hilfetext ermitteln. Befindet 
sich der Anwender allerdings nicht innerhalb des Pull- 
Down-Menüs, findet sich in dieser Variablen ein Wert, der 
durch die Konstante KEIN_MENU (aus der Include-Datei für 
das Menü-Modul MEN .H) repräsentiert wird. 

Nachdem die Nummer des anzuzeigenden Hilfetexts 
über die oben angeführten Variablen ermittelt wurde, kann 
dieser Hilfetext über eine Funktion der Help-Engine auf 
den Bildschirm geholt werden. Bevor wir diesem Vorgang 
jedoch unser Augenmerk schenken, ist es an der Zeit, die 
Erstellung der einzelnen Hilfetexte in den Mittelpunkt 
unserer Betrachtungen zu stellen. 


Erstellung der Hilfetexte 


Voraussetzung für die Anzeige der Hilfetexte ist deren 
Bereitstellung innerhalb einer unformatierten ASCII-Datei. 
Zwar finden sich in dieser Datei bereits alle Informationen, 
die die Help-Engine zur Anzeige der einzelnen Hilfetexte 
benötigt, doch muß diese Datei aus Performance-Gründen 
zunächst durch einen Help-Compiler in ein binäres Format 
gebracht werden. Dieser Help-Compiler (HLPCOMP .EXE), 
dessen Listing Sie auf den folgenden Seiten finden, nimmt 
dabei mehrere Aufgaben war. Er arbeitet sich zeilenweise 
durch die Eingabedatei und führt zunächst eine Kombina- 
tion aus semantischer und lexikalischer Analyse durch, um 
syntaktische Fehler innerhalb der Datei zu erkennen. 
Danach wandelt er die verschiedenen Befehle innerhalb der 
einzelnen Hilfetexte in ein binäres Format um und widmet 
sich im letzten Schritt dann seiner umfangreichsten Auf- 
gabe, der Kompression der einzelnen Hilfetexte. 

Diese Kompression, die die Größe der entstehenden 
Help-Datei um bis zu 45 Prozent reduziert, verfolgt primär 
drei Ziele. Zum einen spart sie Speicherplatz ein, denn 
große Help-Dateien können bis zu mehreren hundert Kbyte 
in Anspruch nehmen, und wenn die Göße einer solchen 
Datei im Hinblick auf die Speicherkapazität einer Festplatte 
auch kaum ins Gewicht fällt, so ist dieser Faktor im Rah- 
men der Distribution Ihrer Programme sehr wohl von 
Bedeutung. Wenn Sie Ihre Programme nämlich auf Dis- 
kette ausliefern, so kann leicht der Fall eintreten, daß eine 
große Help-Datei nicht mehr auf die Lieferdisketten paßt. 
Wenn Sie dann nur wegen dieser Help-Datei eine zusätz- 
liche Diskette ausliefern müssen, kann das Ihre Produk- 
tionskosten unangenchm erhöhen. 

Des weiteren - und dies ist der zweite Grund für die 
Kompression der Help-Datei - wirkt sich die Verkleinerung 
der Help-Datei auch positiv auf die Geschwindigkeit der 
Help-Engine aus. Hier muß berücksichtigt werden, daß die 
Help-Datei nicht am Programmanfang komplett in den 
Speicher geladen wird, sondern die einzelnen Hilfetexte nur 
bei Bedarf aus dieser Datei extrahiert und geladen werden. 
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Da der Zugriff auf Massenspeicher im Verhältnis zur inter- 
nen Verarbeitungsgeschwindigkeit des Prozessors viel Zeit 
in Anspruch nimmt (und die Massenspeicher im Vergleich 
zu immer schnelleren Prozessoren und höheren Taktraten 
immer langsamer werden) kann dank der Kompression 
beim Einlesen des Hilfetexts Zeit gespart werden. 

Dieses Argument führt auch zu einem weiteren Plus- 
punkt für die Kompression der Help-Datei. Um nämlich 
nicht zu sehr von langsamen Massenspeichern gebremst zu 
werden, rüsten mittlerweile viele PC-Anwender ihre Rech- 
ner mit intelligenten Cache-Programmen aus, die sich die 
jeweils zuletzt gelesenen Daten merken und sie bei erneu- 
tem Abruf direkt und ohne Zugriff auf den Massenspeicher 
an den Aufrufer übergeben. Je kleiner die einzelnen Hilfe- 
texte sind, desto mehr von ihnen kann das Cache-Programm 
im Speicher halten und desto seltener muß auf das Spei- 
chermedium zugegriffen werden. 

Auf welchen Algorithmen diese Kompression beruht, 
erfahren die technisch Interessierten unter Ihnen im letzten 
Abschnitt dieses Artikels, doch lassen Sie uns zuvor den 
Aufbau der Help-Datei, wie sie der Help-Compiler erwar- 
tet, untersuchen. 


Aufbau der Help-Datei 


Wie oben bereits erwähnt, erwartet der Help-Compiler als 
Eingabedatei eine unformatierte ASCII-Datei, die die ein- 
zelnen Hilfetexte enthält. Damit der Help-Compiler die 
einzelnen Hilfetexte auseinanderhalten kann, muß jedem 
Hilfetext eine Zeile vorangehen, die mit einem Doppel- 
punkt beginnt. Diese Zeile dient allerdings nicht nur zur 
Separierung der verschiedenen Hilfetexte, sondern gibt 
auch gleichzitig die Nummer des Hilfetexts an, die als Dezi- 
malzahl hinter dem Doppelpunkt folgen muß. In einem der 
obigen Abschnitte wurde bereits darauf hingewiesen, daß 
die einzelnen Hilfetexte Nummern zwischen 1 und 32.000 
tragen können. 

Zusätzlich sei hier noch vermerkt, daß die einzelnen 
Hilfetexte innerhalb der Help-Datei weder in irgendeiner 
Reihenfolge angegeben werden müssen, noch kontinuier- 
liche Nummern tragen müssen. Bis auf den Hilfetext mit 
der Nummer 1, der grundsätzlich Informationen über die 
Hilfe-Funktion und ihre Bedienung enthalten muß, unter- 
liegt auch der Inhalt der einzelnen Hilfetexte keinerlei 
Restriktionen. (Sexistische Anspielungen, Lästereien über 
Microsoft-Produkte und Witze über die Regierung der 
Bundesrepublik Deutschland werden vom Help-Compiler 
allerdings ersatzlos gestrichen und an die Bundesbehörde 
für die Verbreitung jugendgefährdender Schriften weiter- 
geleitet.) 

Was die Größe der einzelnen Hilfetexte anbelangt, so 
gibt die Help-Engine eine maximale Zeilenlänge von 255 
Zeilen vor. Dies darf jedoch nicht als Aufforderung zum 
Schreiben endlos langer Hilfetexte mißverstanden werden. 
Vielmehr sollte ein Hilfetext kurz und prägnant sein und 
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eine Länge von 50 Zeilen daher nur in Ausnahmefällen 
überschritten werden. Die maximale Breite eines Hilfetexts 
kann durch die Konstante MAX_Z_LEN (innerhalb der Datei 
HLPI.H) eingestellt werden. Derzeit beträgt sie 180 Zei- 
chen. 

Neben den Zeilen, die durch einen Doppelpunkt einge- 
leitet werden, mißt der Help-Compiler auch den Zeilen 
eine besondere Bedeutung bei, die mit einem Semikolon 
beginnen. Sie betrachtet er als Kommentarzeilen, die er 
unbeachtet läßt und nicht in den jeweiligen Hilfetext über- 
nimmt. Darüber hinaus kennt der Help-Compiler einige 
Befehle, die an beliebiger Stelle in einen Hilfetext eingefügt 
werden können und grundsätzlich mit einem Backslash 
(’\’) beginnen (Tabelle I). Damit ungeachtet dessen auf 
den Backslash als normales Zeichen nicht verzichtet werden 
muß, steht mit dem \\-Befehl eine Möglichkeit für die 
Eingabe normaler Backslashs zur Verfügung. 

Der Befehl \xhh gibt Ihnen die Möglichkeit, auch 
ASCII-Zeichen in einen Hilfetext aufzunehmen, deren Ein- 
gabe Ihr Editor oder Textverarbeitungsprogramm nicht 
erlaubt (in der Regel die Zeichen mit den ASCII-Codes 
kleiner 32). Die Buchstabenkombination hh innerhalb des 
Befehls muß dabei den hexadezimalen ASCII-Code des 
Zeichens widerspiegeln. Bei der Anzeige des Hilfetexts auf 
dem Bildschirm erscheint dann nicht dieser Befchl, sondern 
das durch ihn repräsentierte ASCII-Zeichen. 

Möchten Sie bestimmte Zeichen innerhalb eines Hilfe- 
texts besonders hervorheben, können Sie sich dazu des \u- 
Befehls bedienen. Stellen Sie diesen Befehl dem ersten her- 
vorzuhebenden Zeichen voran und stellen sie dem letzten 
dieser Zeichen den Befehl \n nach, damit die folgenden 
Zeichen wieder normal dargestellt werden. Das u steht 
dabei übrigens für »unterstreichen«, denn auf einem mono- 
chromen Bildschirm werden diese Zeichen unterstrichen 
(während sie auf einem Color-Bildschirm in einer besonde- 
ren Farbe dargestellt werden). 

Eine wichtige Bedeutung kommt auch dem \v-Befehl 
zu, der einen sogenannten Verweis markiert und einem 
Kapitelverweis wie »siche Seite ...« in einem Buch gleich- 
kommt. Im Gegensatz zu einem Buch enthält ein elektroni- 
scher Verweis jedoch die Seite, bzw. den Hilfetext, auf den 
er verweist, ohne daß er auf dem Bildschirm für den 
Anwender sichtbar würde. Wählt der Anwender jedoch 
einen Verweis an, holt die Help-Engine automatisch den 
Hilfetext, auf den verwiesen wurde, auf den Bildschirm. 

Da Verweise auf dem Bildschirm farblich hervorge- 
hoben werden, muß der Help-Compiler auch das Ende 
eines Verweises erkennen. Dem letzten Zeichen eines Ver- 
weises muß deshalb wiederum der \v-Befchl folgen. Dies- 
mal jedoch muß diesem Befchl die Nummer des Hilfetexts 
(in dezimaler Notation), abgeschlossen durch einen Punkt, 
folgen. Beachten Sie dabei bitte, daß sich ein Verweis über 
maximal eine Zeile erstrecken darf, sich die beiden \v- 
Befehle also in ein und derselben Zeile befinden müssen. 
Allerdings spricht nichts dagegen, mehrere Verweise in 
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einer Zeile anzubringen, denn der Help-Compiler erlaubt 
bis zu 255 Verweise pro Hilfetext, die beliebig über den 
Text verstreut werden können. Wie ein solcher Verweis 
innerhalb einer Help-Datei markiert werden kann, zeigt die 
folgende Beispielzeile, in der ein Verweis auf den Hilfetext 
mit der Nummer 73 aufgeführt wird: 


Text ... \vdies ist ein Verweis\v73. ... Text 


Dieser Art von Verweisen kommt neben der Verknüp- 
fung einzelner Hilfetexte auch die Aufgabe zu, dem Anwen- 
der innerhalb eines kontextsensitiven Hilfe-Systems den 
Zugriff auf allgemeine Informationen zu ermöglichen. Viele 
PC-Applikationen fügen deshalb an das Ende jedes Hilfe- 
texts einen Verweis auf einen sogenannten »Index« an. 
Vergleichbar mit dem Inhalts- oder Stichwortverzeichnis 
eines Buches findet der Anwender hier ausschließlich Ver- 
weise auf allgemeine Themen, etwa über die Bedienung des 
Programms, die Bedeutung der einzelnen Befehle, wichtige 
Tastenkombinationen usw. 

Kann der Help-Compiler Ihre Help-Datei einwandfrei 
kompilieren, erstellt er eine kompilierte Help-Datei unter 
dem Namen der Eingabedatei, allerdings mit der Erweite- 
rung ».HLP«. Dieser Vorgang muß nur einmal vollzogen 
und erst wiederholt werden, wenn Änderungen an der 
Quelldatei vorgenommen werden. 

Beachten Sie bei der Umwandlung des Help-Compilers 
aus der Datei »HLPCOMP.C« in ein ausführbares EXE- 
Programm bitte, daß der Compiler im Gegensatz zu den 
Modulen unserer SAA-Reihe nicht unter jedem beliebigen 
Speichermodell kompiliert werden kann. Vielmehr wurde 
der Help-Compiler speziell für die Kompilierung unter dem 
Speichermodell COMPACT entwickelt und darf nicht unter 
einem anderen Speichermodell kompiliert werden, 


Das SAA-Help-Modul 


Das Gegenstück zum Help-Compiler bildet das Help- 
Modul HLP.C, welches das eigentliche Kernstück der SAA- 
Help-Engine darstellt. Es kann die durch den Help-Com- 
piler erstellten Help-Dateien lesen, einzelne Hilfetexte dar- 
aus extrahieren und sie innerhalb eines Help-Fensters auf 
dem Bildschirm darstellen. Obwohl dieses Modul sehr groß 
ist, sind es nur drei Funktionen und eine Reihe kleinerer 
Makros, die von einer SAA-Applikation zum Zugriff auf die 
Help-Engine benötigt werden. 

Um auf diese Funktionen und Makros zurückgreifen zu 
können, muß die SAA-Applikation neben den Include- 
Dateien der anderen SAA-Module auch die Include-Datei 
des Help-Moduls, die Datei HLP .H, einbinden. 

Unter den verschiedenen Funktionen des Help-Moduls 
steht zunächst die Funktion HlpInit() im Vordergrund, 
die analog zu den Funktionen Violnit( ) (Video-Modul) 
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Zeichen mit Hex-Code hh in Hilfetext aufnehmen 
nachfolgende Zeichen besonders hervorheben 


nachfolgende Zeichen wieder normal darstellen 
normaler Backslash 
Verweisanfang 


Verweisende. Verweis zeigt auf Hilfetext mit 
der Nummer D. 


Tabelle 1: Befehle, die vom Help-Compiler in besonderer Art 
und Weise interpretiert werden. 


und KbmInit( ) (Tastatur- und Mausmodul) zur Initialisie- 
rung des Help-Moduls aufgerufen werden muß. Bei diesem 
Aufruf muß ihr der Name der zu bearbeitenden Help-Datei 
übergeben werden. Aus dieser Datei liest sie die Dekodier- 
tabelle sowie einige Statusinformationen, wie die Anzahl 
der Hilfetexte, ihre Lage innerhalb der Help-Datei etc., ein. 
Anhand eines bestimmten Codes überprüft sie dabei die 
Konsistenz der Datei, denn bereits minimale Fehler - vor 
allem innerhalb der Dekodiertabelle - können beim Zugriff 
auf die einzelnen Hilfetexte zu einem Systemabsturz führen. 
Tritt ein solcher Fehler auf oder ist der Zugriff auf die 
Help-Datei nicht möglich, liefert die HIpInit( )-Funktion 
ihrem Aufruf den Wert FALSE zurück. Er sollte die SAA- 
Applikation dazu veranlassen, das Programm entweder mit 
einer Fehlermeldung zu beenden oder zumindest im weite- 
ren Verlauf des Programms auf den Aufruf der anderen 
Help-Funktionen zu verzichten. Werden Dekodiertabelle 
und Statusinformationen einwandfrei gelesen, liefert die 
Funktion den Wert TRUE zurück und dem Zugriff auf die 
einzelnen Hilfetexte steht nun nichts mehr im Wege. 

Dieser erfolgt, wie bereits beschrieben, innerhalb einer 
speziellen Help-Funktion, die oben mit dem Namen Help- 
Fkt( ) bezeichnet wurde. Sie kann sich zur Anzeige eines 
Hilfetexts der Funktion HlpShow( ) aus dem Help-Modul 
bedienen, der die Nummer des anzuzeigenden Hilfetexts 
übergeben werden muß. Sie öffnet zunächst das Help-Fen- 
ster, das alle andern Fenster überlagert. Dessen Größe und 
Position auf dem Bildschirm werden durch vier Konstanten 
bestimmt, die innerhalb der Include-Datei HLP.H definiert 
werden. HF_X® und HF_Y® spiegeln dabei die Koordinate 
der oberen linken Ecke des Help-Fensters wieder, während 
HF_X und HF_Y die Länge bzw. Breite des Help-Fensters 
angeben. Beachten Sie bitte, daß es sich bei diesen Kon- 
stanten nur um Initialwerte handelt, die jederzeit durch den 
Aufruf der Funktion HlpSetHF( ) überschrieben werden 
können. Solange aber kein Aufruf dieser Funktion erfolgt, 
erscheint das Help-Fenster an der durch diese Konstanten 
beschriebenen Position. 

Während die maximale Größe dieses Fensters nur durch 
die Größe des Bildschirms eingeschränkt wird (vergessen 
Sie bei Ihren Berechnungen bitte nicht den Schatten unter 
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ars Taten 7 


HlpSCHText | normaler Hilfetext 

Hl hervorgehobener Hilfetext 
HlpSCVer Verweis 

HlpSCVerA | aktueller Verweis 
HlpSCFrame | Rahmen um Help-Fenster 

Hl Felder in vorletzter Zeile 
HlpSCSlid 

HIpSCPfeil 


Jdz 


Ey” 


CoL 
CoL 
CoL 
COL 
COL 


verti. & horiz. Slider-Box 
Pfeil an Slider-Boxen 


er 


Tabelle 2: Konstanten, die die Farben innerhalb eines Help- 
Fensters bestimmen, und Makros, mit deren Hilfe diese 
Farben auch noch während des Programmablaufs verändert 
werden können. 


dem Fenster), setzen andere Kriterien der Verkleinerung 
des Fensters gewisse Grenzen. So zeigt Bild 1 z.B. die drei 
Felder in der vorletzten Zeile des Help-Fensters. Da sie 
grundsätzlich in dieser Zeile Platz finden sollen, muß das 
Help-Fenster mindestens 38 Zeichen breit sein. Auch eine 
Mindestlänge von 5 Zeilen darf nicht unterschritten werden, 
da allein 4 Zeilen für den Rahmen, die Slider etc. benötigt 
werden. 

Neben dieser »physikalischen« Grenze stellt sich jedoch 
die Frage, ob es Sinn macht, ein Help-Fenster aufzubauen, 
in dem jeweils nur eine Zeile aus dem Hilfetext sichtbar 
wird. Sicherlich nicht, und so sollte ein Help-Fenster minde- 
stens 14 Zeilen umfassen, damit gleichzeitig jeweils 10 Zei- 
len aus dem Hilfetext angezeigt werden können. 

Trotz der Möglichkeit, die Größe des Help-Fensters und 
seine Position noch während des Programmablaufs zu ver- 
ändern, empfehle ich Ihnen, zumindest die Größe dieses 
Fensters bereits bei der Programmerstellung definitiv fest- 
zulegen und diese Daten auch bei der Erstellung der Hilfe- 
texte zu beachten. Gerade in Bezug auf die Breite des Help- 
Fensters kann nämlich sonst der schr unangenehme Effekt 
eintreten, daß nicht der gesamte Teil der verschiedenen 
Zeilen gleichzeitig sichtbar ist. Zwar erlaubt das Help- 
Modul auch das seitliche Scrolling des Hilfetexts innerhalb 
des Help-Fensters, doch ist dies dem Durchblättern des 
Textes nicht gerade förderlich. 

Neben den oben beschriebenen Konstanten bestimmten 
noch eine ganze Reihe weiterer Konstanten das Erschei- 
nungsbild des Help-Fensters. Sie legen die Farbe der ein- 
zelnen Komponenten innerhalb eines Help-Fensters fest, 
wobei jeweils ein Satz dieser Konstanten für die Ausgabe 
auf einem Monochrom- bzw. einem Color-Monitor exi- 
stiert. Auch diese Konstanten dienen wiederum nur als 
Initialwerte. Stellt die Funktion HlpInit( ) bei ihrem Auf- 
ruf fest, daß die Applikation im Monochrom-Modus betrie- 
ben wird, lädt sie die Monochrom-Konstanten in die ver- 
schiedenen Variablen, während beim Anschluß eines Color- 
Monitors die verschiedenen Color-Konstanten zum Einsatz 
kommen. Darüber hinaus können die Farben einzelner 
Komponenten auch noch während des Programmablaufs 
mit Hilfe einer ganzen Reihe von Makros manipuliert wer- 
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den, denen jeweils die neue Farbe für das Objekt übergeben 
werden muß. Gültig werden diese Veränderungen dann 
jeweils beim nächsten Aufruf der Funktion HlpShow( ). 

Zur besseren Übersicht zeigt Ihnen die Tabelle 2 die 
Bedeutung der verschiedenen Konstanten und den Namen 
des jeweils zugehörigen Makros. 


Durchblättern eines Hilfetexts 


Da ein Hilfetext nur in den seltensten Fällen komplett 
innerhalb des Help-Fensters dargestellt werden kann, stellt 
das Help-Modul dem Anwender alle Möglichkeiten bereit, 
beliebige Teile des Hilfetexts in den sichtbaren Teil des 
Help-Fensters zu holen. Von Seiten der Tastatur her wird 
dies durch die Cursor-Tasten unterstützt. Beachten Sie aber 
bitte, daß die Betätigung dieser Tasten nur Wirkung zeigt, 
wenn der Hilfetext tatsächlich über den sichtbaren Teil des 
Help-Fensters hinausragt. Wenn ein Hilfetext zwar länger, 
nicht aber breiter als das Help-Fenster ist, dann kann der 
Anwender zwar mit Hilfe der Tasten (%), %), (Hone), (End), 
und durch den Text blättern, doch bleibt die 
Betätigung der Tasten *) und () erfolglos. 

Sofern sich innerhalb des angezeigten Ausschnitts des 
Hilfetexts mindestens ein Verweis befindet, gibt es einen 
»aktuellen« Verweis, der farblich besonders hervorgehoben 
wird. Betätigt der Anwender die Taste [+], wird der Hilfe- 
text, auf den dieser Verweis zeigt, in des Help-Fenster 
geholt. Bei der Anzeige mehrerer Verweise hat der Anwen- 
der die Möglichkeit, den aktuellen Verweis mit Hilfe der 
Tasten und zu markieren. 

Ein ganz besonderer Hilfetext, nämlich der Hilfetext 
Nummer 1 mit Informationen über die Arbeit mit der 
Hilfe-Funktion, wird vom Help-Modul immer dann in das 
Help-Fenster geladen, wenn der Anwender während der 
Anzeige eines Hilfetexts nochmals die Taste betätigt. 
Will der Anwender aus diesem Hilfetext in den zuvor ange- 
zeigten Text zurückkehren, kann er sich eine Funktion zu 
Nutze machen, die ihm auch in Verbindung mit jedem 
anderen Hilfetext zur Verfügung steht: Bei Betätigung der 
Tastenkombination (AltJ[F1) holt das Help-Modul den 
jeweils zuvor betrachteten Hilfetext wieder in das Help- 
Fenster. Um wieviele Hilfetexte dabei zurückgeblättert 
werden kann, bestimmt die Konstante ANZ_MERKE, die 
innerhalb des Help-Moduls HLP.C definiert wird. Sie 
bestimmt die Größe des Help-Stacks, auf dem jeweils die 
Nummern der letzten n Hilfetexte gespeichert werden. Ist 
dieser Stack leer, wird pauschal der Hilfetext mit der 
Nummer STACK_EMPTY eingeladen. 

Die Wiederaufnahme der Applikation erfolgt durch 
Betätigung der Taste (Esc), durch die das Help-Fenster 
geschlossen und wieder vom Bildschirm entfernt wird. 

Alle Funktionen, die über die Tastatur erreicht werden 
können, können auch mit Hilfe einer Maus ausgelöst wer- 
den. Zum Durchblättern des Hilfetexts dienen dabei die 
beiden Slider-Boxen, die ihren Namen dem Slider, einem 
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Schlitten, verdanken, der auf ihnen hin- und herbewegt 
werden kann und die Position des sichtbaren Textaus- 
schnitts innerhalb des gesamten Hilfetexts widerspiegelt. 
Wird der Maus-Cursor auf einen der beiden Slider bewegt 
und dann der linke Mausknopf niedergedrückt, bewegt sich 
der Slider (das durchsichtige Kästchen) auf den Maus-Cur- 
sor zu, wobei gleichzeitig auch der sichtbare Ausschnitt des 
Hilfetexts verschoben wird. Bleibt der linke Mausknopf 
weiterhin niedergedrückt, wiederholt sich dieser Vorgang, 
bis der Slider den Maus-Cursor eingeholt hat. 

Wird der Maus-Cursor jedoch direkt auf einen der bei- 
den Slider geführt und dann der linke Mausknopf niederge- 
drückt, so führt das Help-Modul den Slider hinter dem 
Maus-Cursor her, bis der linke Mausknopf losgelassen wird. 
Der sichtbare Textausschnitt wird daraufhin so verschoben, 
daß die Slider-Position die Lage des Textausschnitts wider- 
gibt. 

Ähnlich den beiden Slidern führen auch die Pfeile am 
Rand der Slider zu einer Verschiebung des Textausschnitts, 
sobald der Maus-Cursor auf sie bewegt und der linke 
Mausknopf niedergedrückt wird. Der sichtbare Textaus- 
schnitt wird dabei jeweils um eine Spalte bzw. Zeile in die 
Richtung des Pfeils verschoben. 

Beachten Sie aber bitte, daß auch in Verbindung mit der 
Maus eine Verschiebung des Textausschnitts nur möglich 
ist, wenn der angezeigte Hilfetext über das Help-Fenster 
hinausreicht. 

Die Auswahl eines Verweises mit der Maus erfolgt ein- 
fach, indem der Maus-Cursor auf den gewünschten Verweis 
bewegt und dann der linke Mausknopf niedergedrückt wird. 
Auf die gleiche Art und Weise können auch die Befehle 
ausgelöst werden, die in der vorletzten Zeile des Help-Fen- 
sters aufgeführt sind. 


Das Demo-Programm 


Auch diese Folge unserer SAA-Serie soll nicht enden, ohne 
Ihnen die Fähigkeiten des vorgestellten Moduls an einem 
Beispiel zu demonstrieren. Im Rahmen dieser Folge ist 
jedoch weniger das Demo-Programm selbst, sondern viel- 
mehr die zugehörigen Daten, sprich die Help-Datei inter- 
essant. Diese Demo-Datei, mit dem Namen HLPDEMO.T 
finden Sie auf den folgenden Seiten abgedruckt. Um sie in 
das HLP-Format umzuwandeln, müssen Sie zunächst den 
Help-Compiler HLPCOMP in ein ausführbares EXE-Pro- 
gramm umwandeln (siehe dazu Informationen im Kopf des 
Programm-Listings) und ihn dann mit dem Namen der 
Demo-Datei aufrufen. 


hlpcomp hlpdemo,t 


Die während der Ausführung erstellte Datei HLP- 
DEMO.HLP dient dann als Help-Datei für das Demopro- 
gamm HLPDEMO.C. 
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Datenkompression nach Huffman 


Wie bereits am Anfang dieses Artikel versprochen, möchte 
ich allen Leser, die sich für die Datenkompression inner- 
halb der Help-Engine interessieren, noch kurz in die Theo- 
rie des hier zugrundeliegenen Kompressions-Algorithmus 
einführen. Er läßt sich auf eine Veröffentlichung des fran- 
zösischen Mathematikers D.A.Huffman aus dem Jahre 1952 
zurückführen und stellt neben dem sogenannten »Ziff- 
Lempel-Welsh-Coding« das derzeit populärste Kompressi- 
onsschema dar. Huffman bedient sich einer Idee, die bereits 
den legendären Samuel Morse bei der Entwicklung seines 
gleichnamigen Morse-Alphabets beeinflußt hat. 

Morse verzichtete auf die Informationskodierung in 
konstanten Datenpaketen, wie sie heute etwa im 8-Bit- 
ASCII-Zeichensatz zum Ausdruck kommt, und wandte sich 
variablen Codelängen zu, die den Häufigkeiten der einzel- 
nen Daten Rechnung trugen. Morse, dem es um die Nach- 
richtenübertragung mit Hilfe eines Telegraphennetzes ging, 
untersuchte dazu die Häufigkeiten seiner Daten, also die 
Häufigkeiten der einzelnen Zeichen innerhalb der engli- 
schen Sprache und stellte dabei große Unterschiede fest. 
Die Bandbreite reichte von einer knapp 15 prozentigen 
Häufigkeit des Buchstabens e bis hinunter zu einem hun- 
dertstel Prozent für den Buchstaben x. Dies ausnutzend 
vergab Morse den häufigeren Zeichen kürzere Codes, als 
den weniger häufig auftretenden Zeichen und konnte 
dadurch eine wesentlich geringe Codelänge und gleichsam 
höhere Informationsdichte erzielen, als es mit einem her- 
kömmlichen Code möglich wäre. 

Nicht anders ging Huffman vor, nur daß er die Ideen 
Morses auf eine algorithmische Grundlage stellte und so 
zeigte, wie man beliebige Datenmengen mit Hilfe eines 
Huffman-Codes komprimieren und dadurch bis zu 50% und 
mehr Speicherplatz sparen kann. Als schwierigstes Problem 
galt es dabei, das Problem der Redundanz, also den Beginn 
verschiedener Datencodes mit identischen Codefolgen, zu 
verhindern. Huffman ermittelt dazu zunächst die Häufig- 
keiten der verschiedenen Daten (hier: der Zeichen inner- 
halb der Help-Datei) und sortiert die einzelnen Daten dann 
in absteigender Reihenfolge in eine Liste (in C: Vektor) ein. 


Diese Liste bildet den Ausgangspunkt für die Erstellung 
eines binären Baums, aus dem später die Codefolgen der 
einzelnen Daten ermittelt werden können. Es werden dazu 
zunächst die letzten beiden Einträge innerhalb der Liste zu 
den Blättern eines Knotens zusammengefaßt und die Häu- 
figkeit der durch sie repräsentierten Daten addiert. Je nach 
der daraus resultierende Summe wird der erstellte Knoten 
wieder in die Liste einsortiert, wobei er in der Regel nach 
oben wandert, da er nun mehr Zeichen vertritt, als bei- 
spielsweise der unmittelbar vorhergehende Listeneintrag. 

Dieser Vorgang wird nun Schritt für Schritt wiederholt, 
wobei sich nach einiger Zeit bereits erstellte Knoten wieder 
am Ende der Liste finden und als die beiden Blätter eines 
Knotens zusammengeführt werden. Dabei bilden sich die 
ersten Teile des Baumes. Durch das Verbinden jeweils 
zweier Listeneinträge schrumpft die Liste mit jedem 
Durchlauf um einen Eintrag und enthält schließlich nur 
noch einen Eintrag, der alle Daten repräsentiert und den 
gewünschten Codebaum darstellt. Die Codes der einzelnen 
Daten können diesem Codebaum entnommen werden, in- 
em dieser Baum rekursiv durchlaufen wird, bis alle Blätter 
erreicht wurden. An der Wurzel beginnt man dabei mit 
einem leeren Code und fügt für jede Rekursion nach links 
eine 1 an das Ende des Codes an, während bei einer 
Rekursion nach rechts eine 0 an den Code angehangen 
wird. (Man kann 0 und 1 auch vertauschen, da dies ledigich 
den Code negiert, nicht aber grundsätzlich verändert.) 

Gelangt man dabei an ein Blatt, so repräsentiert der bis 
dato aufgereihte Code die Codefolge das zugehörigen 
Datums. Dabei kann man leicht eine Codetabelle erstellen, 
bei der das jeweilige Datum (in unserem Fall: der ASCII- 
Code des Zeichens) über eine Ordinal-Funktion als Index in 
diese Tabelle abgebildet wird. Das indizierte Element 
nimmt dabei jeweils die Codefolge des Datums auf. 

Nach der Erstellung dieses Codebaums ist die Daten- 
kompression nicht mehr schwer, denn anstatt des jeweiligen 
Datums muß nur noch die Codefolge des Datums aus der 
Codetabelle ermittelt und ausgegeben werden. Gerade bei 
der Ausgabe in eine Datei darf allerdings nicht vergessen 
werden, den Codebaum ebenfalls auszugeben, denn ohne 
ihn kann die Datei später nicht mehr richtig dekomprimiert 
werden. Michael Tischer 


Greifen Sie für uns zur Feder! 


Wir suchen schreibfreudige Experten. 


Wenn Sie Ihr Wissen über Programmierung oder über Standard-Anwendungen nicht für sich be- 
halten und daraus Kapital schlagen wollen, wenden Sie sich an uns. Wir suchen ständig Autoren 
für das Microsoft System Journal und mehrere Buchreihen renommierter deutscher Fachverlage. 


Redaktionsbüro Hartmut Niemeier, 


Theresienstr. 40), 8000 München 2, 


® (089) 28 48 00 


SAA-Benutzeroberfläche in C 


Include-Datei : HLPI.H 

zur Einbindung : der internen Deklarationen für 
satte ramme HELPCOMP.C und HLP.C 

ers 


.1989 
letztes Update an: Et 05.1989 
(Copyright) + 1989 by MICHAEL TISCHER 


/* wir basteln uns ein Byte */ 
Tueder nad char BYTE; 


Kifndef WORD, 
v pede‘ L2} t WORD; 
1: a u 


Hifndef BOOL /* wie BOOLEAN in Pascal */ 
Brad BYTE BOOL; 


Srpadet struct node i. /* Knoten oder Blatt im Baum 6 
typedef NODE * R; /* Pointer auf Knoten * 

typedef BYTE * BPTR; /* Pointer auf Byte * 
Fe} Er hedes u 3 /* Position des Help-Texts */ 


/"=- Konstanten 
4define RG register 
#ifndef Mi, 
Idefine is 
Häefine False I ö 
dendif 


EOeEIn Kin KnNEN [ı} 
idefine ra Uvoia *) 0) /* kein Nachfolger in der Liste */ 


Adefine 10_CODE 0x544d /" identifiziert Help-Datei */ 
Idefine HILFE_TEXT 1 /* Hilfs-Text wit Infos über Hilfe */ 


/*-- Tokens innerhalb einer kompilierten Help-Seite 


#define TOK_ UNTER 0 /* Zeichen werden unterstrichen 
fine NORMAL 1 /” Zeichen werden normal dargstellt 
/* Anfang oder Ende eines Verweises 
#define TOK_ZENDE 3 /* Zeilenende ” 
tdefine TOK_CODE Ir Zeichencode im nächsten Byte / 
* TOK_CODE muß immer das Token mit 
" dem größten Code sein! = 


4define START_STR ASAA Help-Datei! xla* 
4define EXT ‚HLP*  /* Erweiterung kompilierte Datei */ 


idefine MAX_Z_LEN 180 /* naxinale Zeilenlänge */ 
#define MAX_G_LEN 12000 /"maximale Gesamtlänge einer Seite*/ 


/*-- Strukturen und Unions 
struct node /* ein Knoten oder Blatt im binären Baum */ 


BYITE typ /* Blatt oder Knoten */ 
aschh; /* Codes des ASCII-Zeichen wenn Blatt */ 

KNOPER links, /* Pointer auf linken Nachfolger */ 
rechts; /* Pointer auf rechten Kachfolger Y 

WORD anzahl; /* Anzahl der Zeichen, die 

; I” dieser Node Paorhlantiert ) 


struct hpinfo /* geht jedem kompilierten Help-Text voran */ 

pet 

e tenbreite * 

ol Lese I der Textzeilen */ 

/* Kopf einer Help-Datei */ 

char str[ sizeof START_STR ]; /* Anti-Type-String */ 

n [ 1: ap: Code, muß BAa0h sein */ 

int anzahl; /* Anzahl der Help-Seiten in ie Datei */ 
struct hedes /* beschreibt kompilierten Help-Text 
int rot /* Nummer des Help-Texts 


m I" Re riniert 
ons fpos; /* Position innerhalb der Help-Datei 


Listing 1: HLPI.H 


Juli/August 1989 


HLPCONP.C 
2 Ken Ort nd Hein ala a und br: 


sie in das von der He ine 
du] HLP.C) erwartete a} 


Erstellung D JACH 
Aufruf : HLPCOMP Help- 21: 
die Breiten Help-Dat i wird wit e 
der Erweiterung „HLP versehen. A 
/"n= Include-Dateien einbinden »==unununnnunnuunsnuunnunzenn®/ 
Hinclude <dos.h> 


Hinclude <ctype.h> 
#include *hipi.h"  /* Help-interne Deklaratiönen einbinden */ 


/"an Typedefs mnuannunnununnnnnununnnunnnnnnnnenunnnnunnnunnt/ 


Ya a de Ei nn er Mt 2 
struc s ex chre' r im 1 
tpedef f HPD * HPob; 


/"u= Makros #nuunnnnunuununnnunnanunnunnuununnnunnnuunnunnnnt/ 


/*-- die folgenden Makros dienen der Funktion COMPILE() ----*/ 
/*=- und der von ihr aufgerufenen Funktionen ut] 


4define PUTCH(x tr++ ; x, +tanzb 
#define GETCH » N sa ) 


/*-- die folgenden Hakros Se mit der Funktion WRITE- -*/ 
/*-- BIT{) zusammen, -"/ 


#define WB -INITE. kr ) wb_akt = & start = ptr ) 
define WB/GET wb kalt = - weatart ) 

ddefine WB_ENDE() write_bit( -1 ) ) 

/*== Strukturen und Union; „„„mununnunnunnunnenununnunnunnen®/ 
struct codel /* beschreibt die Bit-Sequenz für ein Zeichen */ 


BYTE Ten /* Länge der Bit-Sequenz 


"/ 
{om code [20]; /* Sequenz ist st 19 Zeichen lang */ 


struct hpdes /* geht dem Help-Text im Speicher voran "/ 


struct hpdes * next; /* Zeiger auf nächste Seite */ 
int en, /* dekomprimierte Länge */ 
nummer; /* Nummer des Help-Textes */ 

struct heinfo i; 
: /* erstes Byte des Help-Texts */ 


/*"w» Konstanten ==uuuununnununnunnunonnnunnunzunnunnnnnnnnnet/ 


4define KOMMENTAR ';' /* leitet Komsentarzeile ein */ 
4define START AM /* leitete neuen Help-Text ein */ 
idefine LF "\x0a' 


/*-- Fehlercodes für die Fehlerbehandlungsroutine 


Idefine E_WTEXIST 0 /* 08 Source-Datei existiert nicht 
define E_READ 1 /* Fehler bei A H Kur 
Ri Kae 
3 /* Öffnen de te Ziel- > N unmöglich 
4 /* Fehler bei Schreiben in Ziel-Datei 
3 /* Fehler bei Close auf Ziel-Datei 
6 /* Zeile zu lang 
1: u} einer Help-Seite erwartet 
ungültige Help-Nummer 
p-Text ist leer 
0 /* Help-Text ist zu lang 
hi /* unbekannter Befehlscode 
12 /* Verweis-Ende-Zeichen erwartet 
idefine E.P_ EXP 13 /* Punkt erwartet 


idefine PRINT_WM 6 /* erster Fehler mit Zeilenangabe */ 


/*-- Zeichen-Codes, die bestimmte Befehle repräsentieren ---"/ 


4define CHR_INIT NY /* leitet Befehl ein * 

Karim CHRI\ Bun. /* Zeichen werden unterstrichen "/ 

define CHR_NORMA m /* Zeichen werden normal dargstellt */ 

hierin CHR” "VERWEIS "v' /* Anfang oder Ende eines NorweinsE BY 
/* Interpretation BE kontext-sen 

4define CHR_XY 'x' /* Zeichencode xy, wie in C (' jar: ye 

#define CHR_YZENDE '.' /* Ende der Zahl hinter einem af 


/*n= globale Variablen für Kompressionsteil =«unnuuunnunnuun®/ 
buf err_jmp; /* nimmt ee für LONGJHP auf */ 


um [256]; der binäre Baum */ 
UBES codetab[256]; /* nimmt Codierung der Zeichen auf */ 
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Jen Per jicen Variablen für Kompilationsteil „„munnunnnununnn®/ 
m auf ersten KPD */ 
/* aktuelle Zeiten in dr Help-Datei 7 
Ä pointer auf Streas-Info über 
anzhel u 7° Anzahl der elp-seiten =/ 


/*-- die folgenden Variablen dienen nur der Funktion COM- --*/ 
/"-- PILE() und der von ihr aufgerufenen Funtkionen —./ 


char * zptr; /* Zeiger auf den Antens einer Zeile */ 
int en /* Anzahl sichtbarer Zeichen in der Zeile */ 
anzb; /* Anzahl Zeichen in einer Help-Seite */ 
BPTR bptr; /* Zeiger in kompilierten Help-Text */ 


/"-- die fol Variablen dienen nur der Funktion 
/*=- WRITE_BIT und den Makros WB_INIT sowie WB_GET_LEN 


BPTR wb_start, /” Zeiger auf Anfang des WB- ffers */ 
wbakt; /* Zeiger auf fin « Position ‘ 


/*"= Kompilations-Teil ==uununnununununnnunnnununsnnnnnnenne®/ 


: se waxima) jeweils 64 Köyte 
: LEN: Größe .“ zu allokierenden Spei- 


J Sucht, Kuil'den allokierten eg 
3 t nic pay rl zur Ver- 
ung wird die we er 


„one "aufgerufen. 
—_——_—_ ee“ 


void * alloc( unsigned len ) 
RG void * adr; /* Zeiger auf den allokierten Speicher */ 


if ( ( adr = malloc -- MLL 
„need a; 9 De zu vn Spice 2 


= anne. 


era das nächste Zeichen aus der kein» ® 


. Klee Feransture keiner bu 
* Return-Wert lesense Zeichen oder EOf, wenn * 
as nde der Datei er erreicht wurde. ® 


...........un...................,.,.,:2. |) 


int get_char( void ) 
RG int zeichen; /" das eingelesene Zeichen */ 


if ( (zeichen = fgetel fi} 
(te BASIC HERE a EoF er Iten, Lesefohler? */ 
ir ( ferror( fi 


longjmp( err. 0: I} READ ); Ir st" 
ara zeichen; /* Zeichen zurückliefern */ 


 dhdcihecichcduiichhsleldiddeelchdeslslsbckeieistelsbsiahdelchlelelslelckdchdalebskdslsbskdelslekdl 


„LINE 
: Holt die nächste Zeile aus der Help- 
Datei. 


” 
* Eingabe-Parameter: keiner > 
* Return-Wert 3 Zeiger auf sinen Puffer mit der Zeile. * 
* Info : gr en werden überlesen und * 
y das Lf am Ende einer serie grundsätz-* 
® lich durch '\0' erse 
s - Konnte Beine Zeilen ae lee m wor- * 
” den, weil das Dateiende tser- * 
ke reicht war, wird WLL zurüchgeliefert? 


EEE EEE 


char * get_line( void ) 


static char zbuf[ MAX Z LEN + 1); /" nimmt die Zeile auf */ 
static BOOL ende = FALSE; 


RG int zeichen, /" das eingelesene Befund ” 
/" Nummer 


des Zeicı 
I» Leseschle. fe ‘7 


/* eine kompeltte Zeile einlesen */ 


zeichen = get_cha = EOF ); 
#7 ma ER ander 1} N. BE I \ = 7 


il Pose . Zeichen: /* Zeichen in Puffer holen “ 
Es rien „ion 1 sid: /* Zeile ne R 
ile ( zeichen Di wiederholen, bis Zeilenende */ 
hr, num . 4) 


ite ( zberlo) = 


return z I" NER: auf die Zeile zurückliefern */ 
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I 
il 


: Liest ei iziffri 1] 
as ein ae i wandelt sie 


Hex-Zahl 
fie Hexadezimalzahl 
angetroffen, wird die Fehlerbehand- 


vonnnunnsnnnnnn aegsroutine aufgerufen. 0, 


.—— 
BYTE get_hex( void ) 
RG BVTE zifferl, 
ziffer2: 


—.# 


/* Wertigkeit der beiden Ziffern */ 
if ( Hisndigit( *zptr tisadigit( *(zptr+l) ) ) 
AL, “H RE "ulneh'); si ) 

Ir. d er nach Dezimal wandeln 

W al eL) 

a Gprert ptr ) - 'A' + 10; 

ziffer] = *zptr & 15; 

7 ee Hexziffer nach Dezimal wone: az eh 
x . 

a ee ed ) = 2a 0 36; je Ja */ 


else /* Nein, Ziffer */ 
ziffer2 = *zptr & 15; 


/* Wein, Ziffer 7 


/" Zeiger hinter zweite Hexziffer setzen */ 
roten “ zifferi «4 zei + Ft /* Hex-Wert bilden */ 


: Wird aufgerufen, nachdem COMPILE( 
auf RR SIRLATLONERR Verweis-Zeic 


Eingabe-Parameter: rg 

Return-Wert : keiner 

Info : - Wird kein korrekter Verweis entdeckt,” 
er ir be Fehlerbehandlungsroutnine * 


mn —nnenneneneee 


/ 
void vermeis( void ) 


RG char zeichen, 
"merke; 


int har; |; 
BoOL ende; 


/* jeweils bearbeitetes Zeichen */ 
/* speichert Position */ 
Kummer Verweis-Textes */ 


ende = FALSE; /* jetzt t's erst mal los */ 
PUTCHL TOK VERWEIS ); 3 Vehweischnfang merken =/ 
“ /* Leschleife */ 
aritch ( zeichen = GETCN) ) 


case '\0' : /* Zeilenende */ 
jom el err_jep, EVE_EXP ); /* fehler */ 


case se CHR INIT 
switch! zelchan = = GEICH() ) /* nächstes Z. holen */ 


case CHR_INIT I" noch ein Backslash? */ 
PUTCH("CHR_ init 'P /" Ja, übernehmen */ 
1} /* Länge Telmasneieren if 


'eichen im Hex-Format */ 
zeichen 2 get Tor case ) 


Bar zareseor J; 
De }* ein Zeichen mehr in der Zeile */ 


/* Nerweis-Ende */ 

Riren(-ToRW VERWEIS % erweis-Ende anzeigen */ 
zpfr; I" aiuefte Position merken */ 

“le { edigitl GETCH()) ) /* Zahl lesen */ 


ib ( ®(zptr-1) 1= CHR VZE "Punkt gefunden?*/ 
AM a EPE Br; ! A Fehler */ 
/*-- die Zahl nach Integer wandeln und dann den -*/ 
1 Code i n den Puffer schrei -. 
-1) . \0'; /* Zahl-String beenden Er 

2) ur j "atoi( werke ); 


/* Funktion beenden */ 
/" jedes andere Zeichen */ 
N longjep( err.je, E_VE_EXP ); /* Fehler */ 

break; 
default : ze ug andere Zeichen */ 
PUTCH( zeichen ); * in Puffer a en ”/ 
+len; /* Anzahl der Zeichen inkr. * 

' ; 

„die ( tende ); 
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n 


INSEORRREE ® 


__} 

Aufgabe koordiniert if Br pen Ku der ein- * 

Eingabe-Parameter: Bier Zei a String nit dem Kamen = ® 
der Datei * 


: keiner x 
/ 


Jun 


void — char * datei 


se 

ae za f Puff, In af! dr Help-Text * 

BOOL R RR, et, t es sich wm ein En 
RG NPOP hptr; /* Zeiger auf aktuellen Speicherblock 7 


Jan. st A sheet micher ey 


/" noch keine Heip-Seite bearbeitet */ 


I" erste de born Y 
einlesen und kompilieren *, 


\ ( zptr ) /* Ende der Datei erreicht 7 -/ 
if ( *zptr I= START) /* Start-Zeichen? */ 
longjmp( err_jmp, E_START_EX ); /* Wein, Fehler */ 


nen ROTEN en a 
lern P. EHELPRR ): ee 


anzver = anzb = 5 TER = zeilen = 
JeEY Guter für Kaip-Tent art anıtaaler gl allok. 
hptr = (KPOP) alloel MAX S_LEN + sizeofl 


hptr->next en Dub Betas aleter e 
r- - $ 
un Tboe ) Ir de ua SE bea ten */ 


\ - Hi ach - 

H ( mer: oe eh 7 En er help-Text 2 7 
kezeiten 0n Ankrenae ” 
len = 0; zflentinge initislisieren */ 
while ( zeichen = En ) /* Zeile durchlaufen */ 


f ( anzb > MAX_G_LEN ) uns |; zu viele BR “/ 
eleiet err_jup, E_2_LOMG mar 


if (token ©, zeichen m» CHRINIT) ) /rBefehl?7/ 
tch ri ten") o gendes € untersuc 


case CHR INT : /* ein Backslash */ 
DER. ınır )i £ ist kein Token */ 


rf Zeichen unterstreichen */ 


Zeichen normal * 
r darstellen 7 


case S:: is Einleitung Verweis * 
ein nie Sues Verein) / 
jranzvers /"Anzahl Mia Act har 


case CHR_XY nes Zeichens”/ 
ke SHE m Fe \) Pe = ok CODE ) 
Ba Ken; 
+len; ichen verlägert die Zeile */ 
break; 
default : /" jedes andere Zeichen = fehler */ 
} longjmp( err_jmp, E_UNBEF ); 
is /* kein Befehlszeichen */ 
if MT re Zeichen */ 
Bi zeichen 


k Zeichen in Puffer */ 
"f* Zeilenlänge inkrementieren */ 


en TOK_ZENDE ):; /* Zeilenende */ 


if (len > spalten /* bisher längste Zeile? */ 
ee ya ) I" Ja, Do merken 9 


else /* letzte Zeile oder went Help-Taxt */ 
break; /* Schleife beenden */ 
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/*-- die Bearbeitung eines Help-Texts wurde beendet ---"/ 


if (and) /* ist der Help-Text leer? 4 
{ /* Mein statistische Parameter laden *, 
Wesel Shen, 
ae 
eer-sien - eg + Size hptr->i; 
hptr->numser = helpnr; 
4 /* Ja, Fehler */ 
ses _HLP_LEER ); 
* Anzahl der Help-Texte Sugremngtiores Sf 
Ben, ie er. - „ + sizeof( HPD ) ); 


EU es erste Help- 
hptr; * Ja, Pointer 


Een - hptr; /* Verknüpfung zum Wı 
er = hptr; m /* NPTR ey aktuelle “7 
dite ( zptr ); /" Schleife bis Dateiende wiederholen */ 
isn fps ); /* Welp-Datei schließen */ 


J"== Kompressions-Teil 


z0UT_NAME 


: Setzt den Nasen der tei aus den * Re 
Namen der Source-Datei zusammen. 
Eingabe-Parameter: Source: er auf Namen der Source- : 


tei 
Return-kert + Pointer I Namen der Ziel-Datei in * 
einen statischen Puf Buffer « 


N ET “n...nn../ 


char "out_name( char *source ) 


static char buf[65];  /" Puffer für Namen der Ziel-Datei */ 
RG char * point; / Pointer auf letzten Punkt im Namen */ 


rcpy(buf, source); n Ausgabe-Puffer kopieren */ 

H "Tpoint'= ale, ... ., /* gibt es einen Punkt? */ 

aezembeist, BIT); /* %, rweiterung an Punkt a 4 
n 


Bi er x ie IT auf Puffer zurickiie ern Y 


rear Ber Bit an die aktuelle Posi- * 
tion innerhalb des Puffers, dessen 
Key se über das Makro WB WB. {NIT defi- 
Eingabe-Parameter: ED Wertigkeit des Bits. 


Return-Wert 
E Bei inem Fehler wird A Fehlerbe- 
handlungs-Routine über LONGJMP ange- 


Es Bit-Wert von -1 zeigt an, daß 
das aktuelle Byte 

soll, auch wenn es noch nicht voll 
ist, 


mn unn 


void write_bit( int bit ) 


static BYTE akt_bit = 0; /" Bit-Zähler */ 
static BITE akt_byte = Ö; /* das aktuelle Byte */ 


if (bit ie -1) /* nicht das letzte Bit? */ 
Nein * 


ar se bit; /* das Bit in das Byte einblenden */ 
BETEN t++ == 7) /* ist das Byte jetzt voll? */ 


"wb_akt+r = akt, te in Puffer bri ar 
int "akt ee "0 /r 2 von vorne aRTangee % 


7 das Byte ist noch nicht voll */ 
"akt byte <= ]; /* Inhalt des Bytes nach links shiften */ 


else /* letztes er 7 

if (akt_bit) I" ist diese Byte schon "angebrochen"? */ 

Byte lettieren */ 

akt akt. byte «cn RR -akt.bit );  /* Bits mach links sch. */ 

"ub_akttt = ai te; a eh A 
mahnt ” akt ee :.0: /w von vorne anfangen */ 


1 Se s ich rekursiv durch den he 
wobei für des Blatt um 1 (Ge von! 
den 8 Bit des ASCII-Codes) und für je- 
den Knoten eine 0 aus: 

Eingabe-Parameter: KPIR: Pointer auf die zu bearbeitende * 
Stelle im Baum. 
e„Return-Nert keiner A 


——|||ne]/ 
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PROFI C-TOOLS 


I! Neu Neu Neu 
CURSES 


DER Fenster Manager 
aus der UNIX-Welt 
Jetzt unter MS-DOS 


FORMATION 
DER Fenster-, Menü-, 
und Dialogboxenmanager 
unter CURSES. 

Konzentrieren Sie sich bei Ihren 
Programmen auf das Wesentliche! 
Überlassen Sie UNS die aufwendi- 
ge Verwaltung einer professionel- 
len Benutzeroberfläche! 


| 


Portieren Sie UNIX und XENIX Pro- 


| gramme auf MS-DOS oder umge- 
kehrt 
Entwickeln Sie schon heute Pro- 


Profi-Tools für 


QuickBASIC 


Schreiben Sie schnellere, leistungsfähigere und 

professionellere Programme! Wir helfen Ihnen 

dabei mit nützlichen Tools 

Zum Beispiel: 

© Toolboxen (Fenstertechnik, Menüs, 
DOS-Funktionen etc.) 

® Relationale Datenbank mit komfortablem 
Masken-Editor 

© Grafik-Paket (Geschäftsgrafik und 
Zeichensatz-Generator) 

© Maus-Programmierung 

© Laserdrucker-Unterstützung 

Alle Pakete mit ausführlich dokumentierten 

Quelltexten und Programmbeispielen. Wo erfor- 

derlich, kommen schnelle Assembler-Routinen 


zum Einsatz. Wollen Sie mehr aus Ihrem BASIC- 


Compiler herausholen? Wir informieren Sie 
gerne kostenlos! 


Turbo-Tools 
Turbo-Tools 


C-BTREE- -1SAM 
+ Netzmodul 
Mit kostenloser OS/2 Testversion 


x-sequentielle 
en erkdähige Dateiverwaltung 
für Turbo C, Quick C, MSC: 


» Ausgeglichene B-Bäume modifiziert 
} Über 2 Milliarden Datensätze 

» 750 Schlüssel pro Datensatz 
, Pro Datendatei nur eine Indexdatei 


» Interner Seitenspeicher Ire 


nerbar 
> eich zur Datensicherheit 
» Netzmodule für Novelt, MSNetBios 
kompatible Netzwerke, Banyon Vines 
sowie PCMOS 386 enthalten 
» Unterstützt volles File- und 
Recordiocking 
» Sehr hohe Geschwindigkeil 
» Variable Recordiängen 
» Rebulld- und Reorg- 
C-BTree-Iisam 


gramme auf Ihrem PC für die 
UNIX-Welt von morgen! 

| Für alle gängigen C-Compiler wie 
Microsoft C, Turbo C und Lattice 
Mit ausführlichen deutschen Hand- 
büchern! Alle Tools sind auch mit 
dokumentierten Quelltexten erhält- 
lich 
Fordern Sie noch heute kostenlo- 
ses Intormationsmaterial oder die 


Ingenieur-Büro Harald Zoschke 


Berliner Str. 3, D-2306 Schönberg/Holstein 
Telefon 043 44/61 66 
Eingetr. Warenzeichen: QuickBASIC: Microsoft; 


Inserentenverzeichnis 


Utiity 


Demodiskette für DM 10.— an! a 2000 48/49 (Single-User/Souroe \ DM 375 
NZ 80 C-BTree-Isam/Net . 
BT Tg Zickstei Mult-User/Source) DM 55 
ICKSTEI Kickstein Software 80 (Mu 
= ri 5 A Markt & Technik Buchverlag 80/81, 100 
anfred Kickstein Microsoft 18/19 
Isarstraße 28B Niemeier 76 
D-8900 AUGSBURG 21 | PEM Tillmann Basien 33 
Star-Divisi EDV-BERATUNG GMBH 
= 08 21-81 4666 Star-Division 9 u h 
Te te-wi Verlag 2 er 
Viewe 81 vyc erauer rabe ie 
? & 6380 Bad Homburg 6 
rc Vogel 57 Telefon 06171/41014 
—— J Zoschke 80 Telefax 06172/458652 


Markıälechnik 


EDITION 


f \ k; rıry> 
ni IRB NIRDYL 
® Pryyramsımiar 
NENGDUEN 
ne 28 
a 


Die Bücher der Edition Micro- Microsoft 
soft werden in direkter Zusam- 
menarbeit mit Microsoft erstellt. 


Sie garantieren Ihnen aktuelle 
und ausführliche Informationen 
aus erster Hand. Die Edition 
Microsoft umfaßt bereits acht 
Titel zu den erfolgreichen Pro- 
grammen Works und Excel, dem 
Betriebssystem MS-OS/2 und 
der Programmiersprache 

Quick C. 


Bestellungen im Ausland bitte an: SCHWEIZ 


G.Born Das MS-DOS- 
Programmierhandbuch 

für Version 2.0 bis 3.3 
Hintergrundinformationen zur 
professionellen Software-Ent- 
wicklung. Für Version 2.0 bis 33. 
Inklusive Diskette mit Beispiel- 
programmen in Turbo Pascal 
40/50 zu Themen wie dem 
»20-Files-Problem«, den EXEC- 
Funktionen oder der Erzeugung 
residenter Programme. 

1988, 396 Seiten, 

inkl. Diskette 

Bestell-Nr. 90661 

ISBN 3-89090-661-3 

DM 69,- (sFr 63,50/8S 538,-) 


Markt& Technik Vertr iebs AG, Kollerstrasse 37, CH-6300 Zug 
ÖSTERREICH: Markt& Technik Ver lag Gesellschaft m.b.H., Große Neugasse 28, A-1040 Wien, Tel 
Rudolf Lechner & Sohn, Heizwerkstraße 10, A-1232 Wien, Telefon (0222) 677526, 

Ueberreuter Media Verlagsges.mbH (Großhandel), Laudongasse 29, A-1082 Wien, Telefon (0222) 48 1543-0 


Microsoft 
MS-DOS-3.3-Programmier- 
handbuch (englisch) 
Programmer's Reference in 
englischer Sprache. AufderDis- 
kette finden Sie Programmbei- 
spiele in Assembler sowie eine 
umfangreiche Makrobibliothek 
mit allen DOS-Funktionsauf- 
rufen. Ein unentbehrliches 
Nachschlagewerk für Pro- 
grammierer. 

1988, 484 Seiten, inkl. Diskette 
Bestell-Nr. 90498 

ISBN 3-89090-498-X 

DM 84,- (sFr 77,30/85 655,-) 


Telefon (042) 440550 
efon { 222) 58713930 


M.Kolberg MS-Works 
(deutsch) 

In der Einführung erhalten Sie 
eine Übersicht über das 
Leistungsspektrum des Pro- 
gramms. Anschließend werden 
Sie mit allen wesentlichen 
Befehlen des Programms ver- 
traut gemacht 

1988, 473 Seiten, inkl. 31%p"- u 
51/4”-Diskette 

Bestell-Nr. 90605 

ISBN 3-89090-605-2 

DM 69,- (sFr 63,50/6S 538,-) 


FEN 


werde Verlag AG, Buchverlag, Hans-Pinsel-Straße 2, 8013 Haar bei München, Telefon en 4613-0 Markt Technik 


Bücher 


Schulung 


COMPUTER 
B U CHER 


SOFTWARE 


Ex-C-ellent 


Microsoft Quick c Wegweiser 
Grundkurs 
489 & 


Marktsfechnik 


B.Rosemann, M.Kerres, 
D.J.Schlopsnies, H.Fink 
MS-Excel 

Mit diesem Buch wird Ihnen in 
leichtverständlichen Arbeits- 
schritten der Einstieg in das 
neuartige Planungssystem er- 
leichtert. Im Anhang finden Sie 
Übungsaufgaben zu den einzel- 
nen Kapiteln. Alle Übungsbei- 
spiele mit den Lösungen sind 
auf der mitgelieferten Beispiel- 
diskette enthalten. 

1988, 183 Seiten, inkl. Diskette 
Bestell-Nr. 90515 

ISBN 3-89090-515-3 

DM 69,- (sFr 63,50/6S 538,-) 


Markt &Technik-Produkte 


Duncan 


FRÜHJAHR 


Programmierleitfaden 
IBM ROM BIOS 


DM 29,80 


Marktäeschrik 


Br Lehr und Arbeitsbuch 


EDITION 


R.Haselier/K. Fahnenstich 
Programmieren mit Quick C 
Dieses Buch zeigt Ihnen, wie 
Sie mit Quick C schnell und 
komfortabel eigene Programme 
erstellen können 

® Für den C-Einsteiger ebenso 
wie für den Fortgeschrittenen 
1988, 412 Seiten, 

inkl. zwei Disketten 

Bestell-Nr. 90609 

ISBN 3-89090-609-5 

DM 69,- (sFr 63,50/8$ 538,-) 


Fat AR 
iX CK L 
e R a 


R.Haselier/K. Fahnenstich 
Quick C Toolbox 

Neben einer Beschreibung des 
Standards finden Sie alles, was 
Sie schon immer in Ihrer C-Bi- 
bliothek vermißt haben. Für 
Quick C, Version 1.01 und Micro- 
soft C, Version 5.1. 

Lieferbar 1.Quartal 1989, 
ca.200 Seiten, 

inkl. drei 51/4*-Disketten 
Bestell-Nr. 90674 

ISBN 3-89090-674-5 

ca. DM 98,-*- (sFr 90,20°/ 

öS 834,-*) 


'89 


Ray Duncar 
Programmierlaltiaden 
MS-DOS Funktionen 
148 S. Geb. DM 29,80 

SBN 3-528-04650-3 


NS-D0S 


FUNKTIONEN | 


Markt lechnik 


Einführung und Überblick 


icrosoft 


Dr. N. Meder/G.König/ 
P.Scheuber MS-0$/2 

Dieses erste Buch der Edition 
Microsoft gibt Ihnen - als erfah- 
renem Anwender oder PC-Soft- 
ware-Entwickler - einen Ein- 
stieg und einen Überblick über 
das neue Betriebssystem MS- 
OS/2l 

Die Installation und die ersten 
Schritte werden ausführlich 
beschrieben. Den Schwerpunkt 
bildet der neue Befehlsvorrat 
von MS-OSJ2. 

1987, 304 Seiten 

Bestell-Nr. 90512 

ISBN 3-89090-512-9 

DM 79,- (sFr 72,20/68 616,-) 


Al Dt 
Bu Lates 


«zZ 


Dr. F.M.Sonner/M. Theis 
MS-OS/2 für Software- 
Entwickler 

Im ersten Teil des Buches wer- 
den Themenkomplexe behan- 
deit wie Speicherverwaltung, 
Multitasking und Programmier- 
schnittstelle. Im zweiten Teil fin- 
den Sie praktische Program- 
mierbeispiele, und der dritte Teil 
enthält einen ausführlichen 
Referenzteil. 

1988, 246 Seiten 

Bestell-Nr. 90638 

ISBN 3-89090-638-9 

DM 79,- (sFr 72,20/ö8 616,-) 


" Unverbindliche Preisempfehlung 


Fragen Sie Ihren Fachhändler 
nach unserem kostenlosen Gesamtverzeichnis 
mit über 500 aktuellen Computerbüchern 
und Software. Oder fordern Sie es direkt 
beim Verlag an! 


erhalten Sie in den Fachabteilungen 
der Warenhäuser, im Versandhandel 
in Computer-Fachgeschäften oder 
bei Ihrem Buchhändler 


AA-Benutzeroberfläche in C 


void write_tree( KNOPER kptr ) 
RG BYTE i, j; /* Schleifenzähler */ 
if kptr->typ == KNOTEN) /* an einem Knoten dr J 


write_bit( /* 0-Bit au er 
write” Bere Kir-stinks ) /* Rekursion nach links */ 
write_tree kotr-orechts. } /* Rekursion nach rechts */ 


else /" an einem Blatt angelangt */ 
write_bit( 1 ); /* 1-Bit ausgeben */ 
/*=-- ASCII-Code des Zeichens ausgeben 


for( j=ki Sarg a im; ij; -- 1, j >=] 
wr "y Beljaldı ; ) 


we... wennnnnnenennnennnnen 


„funktion :C0OUNT_OCCUR 


s Intelaljelere sn erben Shi a 

Häufigkeit inne: nen 

Bir: rbereichs. . 
Eingabe-Parameter: KPTR : Pointer auf den Baum-(Vektor). * 
PIR : Zeiger auf den ersten Help-Text « 

im sicher ® 

a mReturn-Wert : keiner n 


vis Be KNOPER kptr, HPOP ptr ) 
int i; /* Schleifenzäher */ 
RG KNOPER nptr; /* laufzeiger in den Baum */ 
RG BPTR Iptr; /* Laufzeiger in die Help-Texte */ 
/*-- den Baum (noch in vektorieller Form) initialisieren --*/ 
for (i=0, nptrekptr; i<256; it+) /* den Baum durchlaufen */ 
er = BLATT; in jeder Elstreg ist ein Blatt */ 
nptr->Vinks = nptr->rechts "ML; _/* keinen Nachfolger */ 


nptr->anzahl= 0; " noch keine a ersittelt */ 
U nptr++ ) )->aschi -i; 'SCII-Code merken */ 


/*-- die einzelnen Help-Texte im Speicher durchlaufen 
while ( ptr I= NIL ) /* alle Help-Texte Mmarbaitert R 
/*-- die Häufigkeit der Zeichen zählen ---- 


for (i » rer Iptr = (BPTR) Aptr->i; i-- i) 
++( kptr + *(Iptr++) )->anzahl; 77 Häufigkei inkr. */ 
ptr = RR /* Zeiger auf nächsten Help-Text */ 


obs hsleieisiehsleishslsishislshsishehslniebstuicistuhshsiniehsiniehsiehsishslsishsietahsiehehsteieheheheteiehsieheheed 


2, funktion :GET_DIFFERENT 


" Aufgabe : Elemeniert die Einträge innerhalb des * 

” Baums, die Zeichen repräsnetieren, die? e 

\% im Text gar nicht vorkommen, 

” Eingabe-Parameter: KPTR : Pointer auf den Baum 

ba „„peturn-Wert : die Anzahl der r ‚aufgetretenen Codes - = 2 
auennnnnnunsnnenennnn nenn sesannannen 


”7 
mp get. se different( KNOPER kptr ) 


RG KNOPER aktptr, /" Ptr zeigt auf aktuellen Node */ 
mptr, /* Ptr speichert der aktuellen Position */ 
endptr; /* Ptr zeigt auf das Ende der Liste */ 

int is /* Schleifenzähler */ 


endptr = aktptr = Be + es, al spointer auf Ende der Liste*/ 
while ( aktptr >= N ) Anfang der Liste erreicht? */ 
il aktper Sanzab m di das Zeichen im Text auf? */ 

--aktptr; ‚ den nächsten Eintrag bearbeiten */ 
else A a Zeichen tritt im Text nicht auf */ 


/*-- nächsten belegten Mode suchen & Liste heranziehen -*/ 
ig ” ee /* aktuelle Position merken */ 
or (i 

aktptr >= kptr 88 aktptr->anzahl == 0; 

++i, --aktptr) 


wencpy( aktptr+l, mptr+l, (endptr-mptr) * sizeof(NODE i 
sul is na: MN an Ninter ER ee, ii 


zen endptr - kptr ); /* Anzahl der Codes zurückliefern "/ 


ee nn SE ee 
e 5, funktion :CoOMP_NODE 


'gabe 3 De zwei Elewente aus dem Baum. 
Einsabe-Peraskter: EL 
e zu vergleichenden Strui 


‚ktu 

Return-Wert : «0 a ELI->anzahl El2->anzahl) 
0 wenn (ELI->anzahl ELZ->anzahl 

ELI->anzahl El2->anzah] 
Info : Diese Funktion wird ner von der Funk- 
tion BUILD_TREE in Verbindung mit der 

Sortierung des Baums über Q' auf- 

rufen. 


in 


Er, 


Listing 2: (Fortsetzung) 
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int comp_node( const void * ell, const void * el2 ) 
"ggg ((KNOPER) e12)->anzahl - ((KNOPER) ell)->anzahl; 


! 

* Funktion :BUILD_TREE 

*” Aufgabe En : Erstellt den binären Baum, aus dem die * 
“ Codesequenzen für wi einzelnen Zeichen“ 
* Eingabe-Parameter: Bm: Pointer auf > Baum. ® 
" Return-Wert 3 u 


177 


void build_tree( KNOPER kptr ) 
int diff_b, /* Anzahl noch nicht eingeg!. Elemente */ 
fl /* Schleifenzähler */ 
RG KMOPER lotto I* rechter Nachfolger */ 
follow /* linker Nachfolger */ 
Iptr;  /* Laufzeiger zum Durchsuchen des Bauns ”/ 
WODE werke; /* nimmt temporär einen NODE auf */ 


/*-- Anzahl der Codes ermitteln und Baum nach aufstei- --*/ 
/*-- gender Häufigkeit der repräsentierten Zeichen sort. --*/ 


diff. t_different( baum 
qsort Kr diff_bel, (has käne), _node ); 

/*-- in der fol Schleife werden jeweils die letzten 
/*-- beiden Einträge in der Liste zum Ian und rechten 
I*- Nachfolger, eines Knotens AusenBengE 

/"-- Danach wird die Summe der durch sie Tepräisstiareten 
/*-- Zeichen ermittelt und der neue Knoten nach diesem 
Ya Ken ie in absteigender Reihenfolge in den Baum 
*-- einso! 

for ( ;diff_ b>0; -diff_b ) 


/*- die beiden letzten Einträge in eine Struktur kopieren*/ 


1follow = (rfollow  jren) alloc(stzeof(maEl 21) * 1; 
"rfollow » * en b); /*letz hf.*/ 
"follow = "(kptrediff_b-1); /*vorl. E. = linker Nachf.*/ 


werke.typ = KNOTEN; /* Eintrag ist ein Knoten */ 
Meier Tinks = follow; / Wi Dran und rechten Nach- */ 
werke.rechts = rfollow; (" folger setzen “/ 
werke.anzahl = rfollow->anzahl + 1fellowsanzahl; 


/*-- neuen Eintrag in die Liste einsortieren -------...-*/ 


for (i=0, Iptrekptr; 
(i < diff_b-1) 's (merke.anzahl < Iptr->anzahl); 
se +Hlpfr 


it (ie diff_b) vr ‚wird Einträg hinten ne 
Platz in der Liste schaffen / 
wemmove(Iptr+1, Vor Hr b - i) * sizeof(MODE) ); 


"Iptr = werke; 


EEE EZ 


! 
„funktion BUILD_TAB 


Erstellt die Tabelle CODETAB, in der 
die Bitsequenzen für die einzelnen Bit-* 
erhaft ver für die verschiedenne Zeichen” 

t we 
Eingabe-Parameter: KPIR : Pointer auf die aktuelle Posi- * 
tion im Baum m 
CPIR : Pointer auf die Struktur, inner-* 
halt derer das Bitmuster für das” 
Zeichen erstellt wird. 
Return-Wert keiner 


Info Diese Ar ie SrDaitat ie rekursive 
durch den Baum, ee genügend 
Spslehir auf dem Stack zur Syerfügung 


= nenne 


void build_tab( KMOPER kptr, UBES cptr ) 
/*-- bereits an einem Blatt angelangt? 


ji (kptr->typ == KNOTEN) 
/* Wein, durch Rekursion dem Blatt nähern */ 


/*-- die Rekursion nach links weiterführen, wobei zu- --*/ 
/*-- nächst eine '0' an den Codestring angehangen wird --*/ 


"(cptr.codercptr.len++) = '0'; 
build_tab( kper-slinks, eptr }: 


/*-- kehrt die Funktion aus der Rekursion nach links ----*/ 
/*-- zurück, wird die letzte '0' im Codestring durch 
Pi -- eine ']' ersetzt und die Rekursion dann nach 

- rechts fortgeführt. 


*(cptr.codercptr.ien-]) = '1'; 
build_tab( kptr->rechts, cptr ); 


else /* Ja, an einem Blatt angelangt */ 


*(cptr.codereptr.ien) = '\0'; fr „eodestring beenden */ 
ZB ERRETREN “ cptr; /* Codestring merken */ 


Listing 2: (Fortsetzung) 
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SAA-Benutzeroberfläche in C 


ten ragen 
der zu schreibenden 
"Bytes 
= Der zu der Datei gehörende File- 
Pointer, 
Return-Wert : keiner 
Info : Bei einem Ausgabe-Fehler kehrt die 


Funktion nicht zum Aufrufer zurück, 
springt zur Fehlerbehandlungs- 


routine. 
EZ 


... 
unse nn“ 


void I write( void * bptr, unsigned anz, FILE * fp ) 
tr, anz, 1, fp ); /* Daten schreiben */ 
[2 /* Fehler beim Schreiben? */ 
N longjmp(err_jap, E_WRITE); Ir a“ 
ii; 
sCHP _WRITE 


: Komprisiert die einzelnen Hel peie 
und Pe A den Vektor 72 Piter 


schiedenen Datenbiöcke, ia > Ar neue 
Eingabe-Parameter: Ka bir auf den Dateinamen der 
zu erstellenden Datei 
Return-Wert : keiner 
.———..—.——;_;_;;. 


.............n 
a a a 


void cap write( char *datptr ) 


RG BPIR treeptr, /* Zeiger auf Puffer wit Baum */ 
/" Dumay zum Zwischenspeichern eines Ptr */ 

/* Zeiger auf tesporären Puffer */ 

e I" laufzeiger in un... Puffer */ 
int 5 Länge des Codebaums */ 
; /* temporäre Variablen */ 

Hop ae er Zeiten auf Vektor wit Beschreibern */ 


R fzeiger in den obigen Vektor */ 
KPOP hpdp; LENTESIBBF IE, in Help-Texte im Speicher */ 
char * Pay Ad Pau ” das Bitmuster eines Zeichens */ 
FILE ga >00 für Ausgabedatei */ 
struct ler kopf; * Kopf einer Help-Datei */ 


/*-- Code-Baum in Puffer schreiben und ale ersitteln ----"/ 

tr = (BPTR) alloc( 2048 ) nz KB allok. * 
Pit yeagr |; a7 i / 
un tree( 


tree_len = WB_GET LEN(); 
treeptr = reaTlocl treeptr, PR 


R -- Puffer für Vektor allokieren 
hedp = hedp = a Vest krıtaien (enzheip s 1) = sizeof(htd) }: 
/*-- die einzelnen Bahr is Speicher durchlaufen, sie -*/ 
/*-- komprimieren und dabei gleichzeitig Kenndaten in den -*/ 
/*-- Vektor eintragen Be] 
printf("\tKomprisierung Help-Text 
es. “sta 
ren iin, struct header ) + tree_len + i; 
Kr /* weiteren Help-Teit bearbeiten? “ 
printf(*\b\b\b\b\bESd*, Ihcdp->har » Ihpdp->nummer 
I". rn inrichten und Help-Text in - 
I ee Pre er ; 
r « tptr = alloc -»i« en» 
werte br } dptr - ) a i) 
U bptr ); 
te .- „ die gimeiene t Puffer durchi. * 
v) ” und er r Bultafter ad H u 
ende a + Mio), nn ende; ne Da tar Bolenr/ 
ile t t ausgeben * 
write_bit( "code & 1 ); 
gt m aan 3 
ree( tptr ); er 
- EEE I" farm auf nächsten Help-Text */ 


/*-- Dateiposition des nächsten Hel t t 
(Ihcapeiy-Pfpas e Ihedpentpan e we ber ne 


++lhedp; /* nächsten Na bearbeiten */ 
printf("\n*); 


/*-- Help-Datei im Binär-Modus öffnen 


Todajenlere Jap. e-ber eben): I? Und act geöffnet werden */ 


Listing 2: (Fortsetzung) 
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werte Ki a, TEN I" Vektor ausgeben */ 
(write( treeptr, tree_len, fp ); /* Baum ausgeben */ 


/"-- die einzelnen Bale-Tert im Speicher durchlaufen und -- 
/"-- in die Datei schreiben 2 
prinef("\tAusgabe Help-Text sessessonnusanee 0*); 


ae ” start_hpd /* Zeiger auf ersten Help-Text */ 
( ML a Bi rt Weiteren | bee bearbeiten? */ 
Im nen komprimi Ip-Text ausgeben */ 


Kine fi Nun Be ee = hedp->fpos, fp ); 


Ptr auf nächsten Vektor- Eintrag */ 

Ingo? 5 Ihpdp->next; En Zeiger auf nächsten Help-Text */ 
"vg a ”/ 

I* dal 4 


„DRIVER 
D die indie grade er hen 
+: Ben sat sowie zur Aa tafından 
Eingabe-Parameter: 
ARGV : wie beim MIN) 
Return-Wert : keiner 
void hipe_driver( int arge, char "argv[] ) 


UBES /* beschreibt AISDE eines Zeichens 7 
u} ee Zeile 


k: Code-Tabelle *); 
rt_hpd ); i. läufigkeiten ern. ern. Y 


a kein Codelement uganndelt 
/* Codetabelle aufbauen e 


+ 
+ 
’ 
} 
A 
* 
* 
H 
’ 
Ei 
‘ 
2 
2 
| 


| 


.s......s„.n 


- 


int main int arge, char *argv[] ) 
static char *err_mes[] * /* Fehlermeldungen */ 


"Die Source-Datei existiert nicht*, 
Man bei Lesen der Source-Datei”, 


icher 
Die mi. Ektei tn I nicht fiat werden”, 
"Fehler bei f auf Ziel-Date 
"fehler beim Schließen der Tieledarsie, 
"Zeile zu In 
"Anfang einer Help-Seite erwartet”, 
ütlige Help-Nummer*, 
*Help-Text ist leer”, 
‚Help-Text zu zu la: er: 
"Unbekannter Befehlscode*, 
"Verweise-Ende-Zeichen erwartet”, 
"Punkt erwartet” 
unsi fehler; /* nimmt Fehlercode von SETIMP auf */ 
printf(” HELPCOMP - (c) 1989 by MICHAEL TIS" 
“ n'); 
if large» 2 /* ungültige Anzahl Argumente? */ 
printf(? nNELPCOMP bereitet Dateien auf die Mei ir 
rch die\nSAA-Help-Engine vor. a rg Sie daz* 
"u beim Aufruf des | Senschiun der\nzu be* 
varbaitenden. Datei an. HELPCOMP erstellt aus dies“ 
sor\nDatei eine SM -Hei-datei wit der Erweiterung“ 
“\e,nLp\®. „ala u aforaationen zu diesen ” 
zogramm Sie in\nder »/August-Ausgal re 
". Meruart System Journal.\n*); 
return( I ); 


u /* es wurde genau ein Argument übergeben */ 
if ( (fehler = aa ahtenang) Er FR Are vos SET 


„% 
tor par en N la ordnungsgemäß kompiliert */ 


eise /" LONGIMP wurde bei einem Fehler aufgerufen */ 
if ( fehler >- PRINT /* Zeile a Bi > 
pelaeHl ara in z Yn: s1d.: %s.\n*, r 
zeile, err_mes[ fehler ); 


/" Nein */ 
rt tf(*\nfehl % e fehler 
rin ‘ Nr ER u an Riertart Mel ickliefern */ 


Listing 2: (Ende) 
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SAA-Benutzeroberfläche in C 


Include-Datei H . z 
zur Einbindung : der Funktionen zur Bildschirm- 


4 
erstellt am 9.05. 1988 
letztes Update am: 2: 05.1989 


(Copyright) » 1989 by MICHAEL TISCHER 


/*-- Typdeklarationen 


Fifndef BOOL /* wie BOOLEAN in Pascal */ 
Pine f BYTE BOOL; 
jendi 


/*-- vordefinierte Konstanten für die Farbcodes der ver- ---*/ 
/*-- schiedenen Objekte innerhalb des Help-Fensters tr 


Farben im monochrom-Hodus 
/* normale Zeic ” 
/* unterstrichene Zeichen 
/* Verweise ” 
/* aktueller Verweis 

/* Rahmenfarbe 

/* Buttons 

/* Slider 

/* Pfeil an Slidern 


/* Farben im Color-Hodus 
#define COL_N COL /* normale Zeichen 
Adefine COL_V COLL GEL! AN v BEWaET, Zeichen */ 
#define COL_Y COL I* W 
JARZ ir aktueller Verweis 
/* Rahmenfarbe "/ 


ine COL’BU COL /* Buttons 
#define COLSL COLL CYAN, SC )  /* Slider 
Adefine COL-PF COL( CYAN. SCHWARZ) /* Pfeil an Slidern 


/*=- Position und Größe des Help-Fensters 


#define HF_XO 5 /* Startspalte */ 
4define HF/YO 5 /* Startzeile */ 
#define HFX 64 /* Fensterbreite (inklusive Rahmen ) */ 
#define HFY 15 /* Fensterlänge (inklusive Rahmen ) */ 


/*-- Makros zum Setzen der Farben 


4define HIpSCHText( c ) ( co] - - ze /* normaler H-Text 
#define HIpSCV ) /* Verweis 
/* aktueller Verweis 
/* unterstr. H-Text 
/* Rahmen um HF 

/* Buttons 

/* Slider 


ine H 
4define H] SH NR] 
ß ee) /* Pfeile an Slidern 


#define HIpSCPfei 


/*-- externe Variablen 


Sp - € 


extern BYTE col_n, /" die versch. Farb-Variablen 


BOOL HipInit Fe “ Anptr 3 
void HlpShow w.)3 
void Hipseth ( sit 0) BYTE yO, BYTE x, BYTE y ); 


Listing 3: HLP..H 


EEE u 2 2 2 5 2 2 nn 22 N 
Ir } 


: stellt eine ee in Verbin- 
dung mit den verschiedenen Moduln 
der SAA-Reihe zur Verfügung. 


entwickelt am 


letztes Update : 20. 


Erstellung » CL en HLP.C /C 
dann wit t einem anderen Modul linken 
T Aulohshebelubelelhshuiaishsichsskainhshuhahahshahebshahen ee 


/*"= Include-Dateien einbinden „„mununununennnnunnunsnunnunnt/ 


#include <stdlib.h> 
#include <stdio.h> 


Listing 4: HLP.C 
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/* auch die SAA-Include- */ 
/* Dateien einbinden " 


.h 
Finclude "hipi. h" 
#include *hip.h* 


/*== Makros uu...n...n...... munnunt/ 
#define StartByte() (akt_bit = 1) /* für HipiGetBit() */ 


#define InitHSlider hslider = 0 
#define InitVSlider Sie j 0) 
4define GetYSlider 
#define GetHSlider: Kellder } 


/*-- Zugriff auf den Mausbereich in Verbindung mit der 
/*-- Funktion HipiMoudelay() 


Adefine SetMBer( = ) ( mber = "k 
Idefine Besser) Seiler! IN_BEREICH ) ) 
idefine GetMBer() uber 


/*== Typdeklarationen ee 


Se oc ee, 
typedef VEL * VELP; /* Zeiger auf ein VEL */ 
/"== Strukturen und Unions “„munnunuuuununnunnnnnunnuunununet/ 
struct vdef /* Beschreibt einen Verweis */ 


BYTE spalte, id Eat farsung von. der oberen linken */ 
zeile, I* Ecke des RT exts “/ 
len; /* Anzahl der Zeichen im Verweis */ 

int var; /* Nummer des adressierten Help-Texts */ 


/*== Konstanten s=uunuuuunnnnnunnnneununnnunnunnnunnnunnnnen®/ 


/"-- Pausen für HipiMouDelay() 


Idefine SHORT DELAY IL /* 1 Ticks = 1/18 Sekunde */ 
define LONG_DELAY 9L /" 9 Ticks = 1/2 Sekunde */ 


Adefine YW_STR *<\x11/=Verweis>" /* Buttons im */ 
Idefine HIZSTR "<Fl=Hilfe> /* Help-Fenster */ 
#define BA/STR "<ESC=zurück>" 


idefine HELPRA_H zus /" Rahmen um Help-Fenster horizontal 
4define HELPRA_V E /* vertikal 


#define LAST HT -1 
Idefine STACR_EMPTY 2 


#define KEIN_VERWEIS 255 


Idefine - PRED -1 
ddefine SISUCC 1 


#define ANZ_MERKE 20 


/*»= globale Variablen »»"mmnunnununnunnununnnnunnnunnunnnnnt/ 


/* Wurzel für für Moice n Baum */ 


t 
/” wenn der Help-Stack Ri ist 
/* kein aktueller Verweis 


/* Konstanten für HlpiSuchev() */ 


/* Rückblätterungs-Tiefe */ 


/* Anzahl R Help-Texte in 2 Balb-bacat ”"/ 
der Help-Datei */ 
Ir Baip-Fonster linke Spalte */ 
/* Help-Fenster obere Zeile a 
/* Help-Fenster Breite in Spalten * 
/* Nelp-Fenster Länge in Zeilen */ 


/*-- globale Variablen im Zusammenhang wit dem jeweils -- - 
/*-- aktuellen Help-Text 


/* Nummer des aktuellen Mausbereichs */ 
struct hpinfo hi; /* Anzahl Verweise, Spalten & Zeilen */ 


Ir Darbendes für die Zeichen innerhalb eines Help-Texts, -*/ 
/*-- den Rahmen des Help-Fensters etc. ee 7} 


/* normale Farbe */ 

ad ag ee “ 

n akene) er Verweis "7. 

/® Rai Help-Fenster */ 

ir Hilfe-Bu ton etc. */ 

/* horizontaler gr vertikaler Slider */ 
/* Pfeile an den Slidern */ 


/*- Help-Stack wit Nummern der letzten ANZ_MERKE Help-Texte */ 
int hstack[ ANZ_WERKE + 1 ]; /* FIFO-Stack */ 
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BYTE HipißetBit() 
static int akt_byte; /* das aktuell bearbeitete Byte */ 
if (--akt_bit == 0) /* in ein neues Byte “r 2 


kt_bit = 8 wieder im Bit 8 * 
akt-byte = kgete( fp ); /* ein Byte Ri der Dates Fe “ 


ih ‚byte <em 1; /* um eine Position nach links shiften */ 
return( *((BYTE *) &akt_byterl) & 1 ); /*Bit zurückliefern*/ 


: Liest 8 Aefeinangarıo Bits aus 
2; Help-Datei lt sie in ein * 
te um. 
" Eingabe-Parameter: keine 


* Return-Wert : Das eingelesene Byte , 


BYTE HipiGet8Bit() 


int retw; /* der rn-Wert */ 
RG BYTE i; Ir Schtetfenzähler ef. 


KenBL ALFA Pi * Byte-Code einlesen */ 
use ls a it BR Bit 8 Wien und dann shiften */ 
Tup Te Tre 3) 4) = HipitetBit(); 


/* Byte zurückliefern */ 


: Erstellt den gen im. - Zeichen: 
uenzen für die einzelnen Zeic! 
rmittelt werden 
Eingabe-Parameter: BPIR : Pointer auf die aktuelle Posi- * 
tion im Baum ii 
Return-Wert : keiner. ” 
EI I 2 I 2 2 a 2 2 zz a 2 2 a 2 nz Ze nz 2 2 zz nn zn N N N U Ir 


ul / 


/ 
“., 
” 
” 
” 
” 
” 
“ 


void HIpiBuildTree( KMOPER bptr ) 
RG KNOPER Freien, /* rechter Nachfolger */ 

follow; /* Yinker Nachfolger */ 
BYTE 73 /* Schleifenzähler */ 
int aschi; /* ASCII-Code des Blattes */ 
if ( HpißetBit() -- 0) /* ein weiterer en ” 


BEE FEB): - y 
1follow = tern = (KNOPER) malloc(sizeof(MODE) * 2))+1; 


I*-- Zupkchst chst den Baum nach links rekursiv durchlaufen --*/ 
HipiBuildTree(bptr->links = follow); 


/*-- nach Abschluß der Rekursion nach links erfolgt je- -*/ 
/*-- weils die Rekursion nach rechts -"/ 


HipiBuildTree(bptr->rechts = rfollow); 
else I" an einem Blatt angelangt */ 
POLE. BLATT 


tr->links = keS suchte =NIL; /* kein Nachfolger */ 
verrasch = HipiGet8Bit(); /"ÄSCII-Code holen & Barteer) 


III IE 


EN 


BYTE HipiGetByte() 
RG KNOPER bptr; /* Zeiger in den Baum */ 
bptr = &baum; /* an der Wurzel des Baumes beginnen */ 


/*-- Innerhalb des Baumes bis zu dem Blatt wandern, das ---*/ 
/*-- die glesene Bit-Folge repräsentiert tf 


whil > 
bptr | nisiesieens ) } bptr->rechts : bptr->links; 


‚Panne bptr ->ascii ); /* ASCII-Code zurückliefern */ 
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sizeof( VW_STR ) - 1 
sizeof| HI_SIR ) - 1 
idefine SB ( sizeofl BA/SIR ) - 1 
RG BYTE ij; /* Schleifenzähler zum Laden der Maus-Pointer */ 
/*-- Koordinaten Hilfe-Feld 
EA A Re 
.hfx0 + hix - 2; 
MenemtoTe: 'heyoshfy- 2; 
-- Koordinaten Verweis-Feld 
=; TeT Ia:E- m 
xl = mouvek „x 
y} = mouvek ey 2; 
I*-- Koordinaten ESC-Feld 
2 = = ! “a - 
.x] = mouvek xl - % -B+1; 
‚yl = mouvek[ 2 ern 2; 
*-- Koordinaten De 
3 


'ek x] = mouvek x2 «hf x0 +]; 
zeit } .yl ei 1:2 .y2 = hf/yO + hiy- 3; 
Koordinanten horizontale Slider-Box 
e\ -hfx0 + 
ee ho + Bi x- 
ET yore kty.- % 
*-- Koordinaten Pfeil rechts 
went I% xl= must: ]: ‚2 = 
.yl = mouvek ya 
/*-- Koordinaten Pfeil oben 


ee ang 


/*-- Koordinaten vertikale Slider-Box 


BEER RE ES hi_xO + hf x - 1; 


mouvek| 8 1. 
De 


/*-- Koordinaten Pfeil unten 


Dr mmmeki 9 Jo2 ra a hin; 
en 8 Dr fen 0 Br er 


/*-- alle Bereiche werden mit einem einheitlichen Haus- 2 
/*-- Cuirsor versehen .f 


fr (i-0; i<10; 
ern kLi ].ptr_mask = holperkaskt PTRSAHECHAR, PTRINVCOL ); 


DT 


:#1piMouDdelay 


: Stoppt die Programmausführu 
nun Larzen Moment, damit sic - 
du! gegenüber der Maus nicht zu sensi- 
tiv verhält, 
Eingabe-Paraneter: MOUB = aktueller Mausbereich 


Return-Wert : keiner 
I Zn nn an a EEE EI I I z 


void HipiMouDelay( BYTE moub ) 


long ticks, /" zu erwartende Uhrzeit */ 
akt; /* aktuelle Uhrzeit */ 


/*-- aktuell erg a und Ziel-Uhrzeit berechnen 
El timeofday( _TIME_GETCLOCK, Eu: 

per be 3 eeihbert) ? SHORT_DELÄY : LONG_DELAY ); 
/*-- warten, bis die Zeit verstrichen ist 


Bl timeofday( _TIWE_GETCLOCK, Sakt ); 
while T akt < ticks ); 


SetMBer( moub ); /" neuen Mausbereich merken */ 
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s ert die 
im Kortsnisien Slider. 
Eingabe-Parameter: SPALTE = en zo  bmpssltise an Vinken® 


des Help-Fensters 
Return-Wert : keiner 
_——.___;_eeeeeeee / 


void HIpikslider( BYTE spalte ) 


ae BEN 2 + hslider ir Br co) ei FALSE, FF 
en <= hf_x - TexE schmaler als m: 
lider i nee 0 


die En 
hslider = spalte * ji hl 
nern iz +hs ider- Ei w 


Jer.—.,—,unnuunnnnennnnnnennene 


sKlpiv$Slider 


: Markiert die aktuelle Zeilenposition 
im vertikalen Slider. 
Eingabe-Parameter: ZEILE = neue Deren pad bis Ban am oberen 


Return-Wert : keiner 
.. 


void KipivSlider( BYTE zeile ) 


Herel t{ vR(0),. Vol 2 + vslider ), col_s1, FALSE, 
Dino. 1; 9 I „ Test Krzer af ie 
= ider = 0; ne lider in Zeile 0 J 


else I" 
vslider = zeile* (hiy-7 
aka vR(0), vol 2 # vslider ), col _sı, FALSE, 


: Stellt fest, ob sich ein Verweis 
ndest teilweise innerhal 
Help-Fensters befindet. 
Eingabe-Parameter: YNR = Numser des Verweises 
SPALTE, = Zeichen innerhalb des Help- 
ILE Texts, das in der oberen 
nken Ecke des Fensters 
dargstellt wird, 
Wert ; slelen sich der Sermeis im sur 
Ip;fensters be ee TR 


'| 


BYTE HIpivir( BYTE var, BYTE spalte, BYTE zeile ) 
int diffz, /* Differenz in Zeilen */ 
diffs; /* Differenz in Spalten */ 
RG VOP Ivdp; /* laufzeiger in den Verweis-Vektor */ 
diffz » uen - ve + A nah - zeile; 
if diffz >= 2: 
verais- ile innerhalb des HF */ 
= Ivdp->spalte 


% Kakasın) hf, alte diffs ehe ln ae nel: < al, 
return ; * Verwe 


ar FALSE; /* Verweis außerhalb des Help-Fensters */ 


Eerrennnnnneeneenenn 


! 
2, Funktion ı#lpiSucheV 


: Sucht den nächsten Verweis innerhalb 
des Help-Fensters. 

Eingabe-Parameter: VNR * Nummer des aktuellen Verw. 
OFFSET = Suchrichtung 
SPALTE, = Zeichen innerhalb des Help- 
ZE Texts, das in der oberen 


; KEIN Vs kei Vera 
‚ wenn kein s 
funden wurde a 


Info : für SICH 1 können “ ae PRED 
suc SICC ( Suche 
chfolger | Beben ren 

BYTE HipiSucheV(int var, int offset, BYTE spalte, BYTE zeile) 


U pann den Verweis-Vektor ausgehend vom akt. Verw. durchl. --*/ 
je vart=offset Agrar Mine var < hi,vermise; ey 
Mpivirl var, spalte, . iR /* Verw. im HF? * 
al, var; Nummer zurückliefern */ 
ae KEIN_VERWEIS; /* keinen Verweis entdeckt */ 
_.-_—._;ee 
ıHlpicolorvV 
: Färbt einen Verweis innerhalb des 
Help-Puffers und innerhalb des Help- * 
Le ce ein, somit er dort Saskauigt : 
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" Eingabe-Parameter: VNR - * Iumer des Verweises 
® ARBE 


Fi neue Farbe 
SPALTE, = Tim innerhalb des Help- 
ZEILE 1 I “ in der oberen 


Return-Wert ı keiner 


nun. 


void KipiColorY(int var, BYTE farbe, BYTE spalte, BYTE zeile) 


RG VELP Iv; /* laufzeiger in den BAR Jenke mirst ”/ 
4 verweis; /* Informat tio übe: s" 


Re Int diftz, / 
starsp, /* Startspalte auf Bildschirm */ 
endsp; /* Endspalte auf Bildschirm */ 


verweis = *( vdp + Ei /* Nerweis-Daten holen */ 
Iv = velp + Dariket 2 @ * hi.spalten + verweis.spalte; 


/*-- Verweis innerhalb des Help-Text-Puffers einfärben ----*/ 
for ( i = verweis.len; i-- ; ) 
Iv#+->h.attribut = farbe; 


- ya: zeile - zeile 
Hr ji aitfe >= 0 38 diffe < Afly-4 ) /" Zeile im Fenster? */ 


/* Startspalte Y 
£ Een 4 


Sn SR] sichtbar*/ 
LONBSEBaIB ur? ”/ 


ee Auf - FÜ egg e - og 


A n HM x) 
ou TR are ER ‚The x R 
IR ee <0) m. Ir palte 
- ku „w 
I* Endspal 
/" Ja, am Eu 
vol 1 + diffz ), 
„weis Par )» farbe ); 


: Scrollt den Inhalt des Help-Fensters ” 
u wm eine Zeile unten. “ 
Eingabe-Parameter: Zu = Zeichen innerhalb des Help- * 
Texts, das in der oberen ® 

inken Ecke u Popstars » 

dargstellt wird. en 


Return-Wert g ner 
——. Kun eh hehe A 
void HipiScrollDown( BYTE spalte, BYTE zeile ) 


u VELP Ivelp; /* Laufzeiger in den Help-Text-Puffer */ 
RG BYTE endspi /* Endspalte für Text */ 


KouliideMouse(); /" Maus-Cursor ausblenden */ 


Yiederettßomt Feel “ Rt. 2, wi- ur „1, MOCLEAR } 
Ar ng 
„yierutl Kan wc). Pr ii Fo, Ivelp ): 


Merk! Mi Mi h ht UM 38; KR 


N VioClear( endsprl, R(-1 vol. di nn); 


KlpivSlider( zeile-] ); /* horizontalen Slider anzei 
Moushomlouse() ; /* Maus-Cursor wieder einb] 


I ee 


ı4lpiScerollup 


: Scerollt den Inhalt des Help-Fensters 
ua eine Zeile nach oben. 
: SPALTE, = Zeichen innerhalb des Heip- 
ZEILE Tats: das in der oberen 
nken Ecke des Fensters 
dargstellt wird. 
: keiner 


Es wird davon ausgega daß sich in 
‚neuen letzten Midschirmzeile Text 


u 


i 
E 
: 
Fr 
5: 
Ib 
E 


void MipiScrollup( BYTE spalte, BYTE zeile ) 


RG VELP Ivelp; /* laufzeiger in den Help-Text-Puffer 
RG BYTE andsp; /* Endspalte für Text 


Koukidelouse(); /* Maus-Cursor ausblenden 


pain Yudı), vol), Pay ı Ne -3),.3, NOCLEAR ); 
li RE 1< ER Ge et 
je an we Rihewten), vn; ee 


* 
— 


” 
= 


“Y ss 
Yioput u andıp 3), Ivel 
Hei © spe], re an Ri AT vi n) 
HipiVSlider( zeiler ); K horizontalen Slider anzei 
MouShowlouse(); * Maus-Cursor wieder einb] 
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m... nennen 


sKlpiSerollleft 


: Serollt den Inhalt ee Welp-Fensters * 
un eine ale in ” 

Eingabe-Parameter: SPALTE, = Zeichen innerhalb des Help- ” 
ZEILE a das in der oberen ud 

linken Ecke des Fensters = 

dargstellt wird. . 

22 li RE 8 
nfo ausgegangen n® 
aaen Tatztan. s Yrchlreenatıe ® 
"Befindet. > 
/ 


Hennntnnnnnnnunnenerennesennnentnn nun nennen anne rennen ne 


id HipiScrollleft( BYTE spalte, BYTE zeile ) 


RG VELP Ivelp; /* Laufzeiger in den MEEETESESPEfer In A 
RG BYTE i, /* Schleifenzähler */ 
endsp; /* Endspalte */ 


RE /" Waus-Cursor ausblenden */ 


endıp Ri li /* Endspalte berechnen */ 
Vleteratiiaft {2}, Of), endep, 3), I POCLEAR h 
Ivelp = velp + zeile * hi.spalten + spalte + IR x - 2 


Ir die einzelnen Zeilen des Fensters durchlaufen 
for (i 2% 


i« wer, "38 zeile < hi.zeilen; 

++, +rzeile 
{ /* Zeichen am Bu u m Fenster-Rand ausgeben * 
VioPut( endsp, i, endsp, i RA 
ie +- hi. spalten; ger auf nächste Zeile */ 


HipiHSlider( spalter) ); /* horizontalen Slider anzeigen */ 
AIR zes I /* Maus-Cursor wieder Siablenden “ 


s ap den Inhalt des Heip-Fensters 
eine Spalte nach rechts 
Eingabe-Parameter: SALE, = = Zeichen innerhalb des Help- 
ZEILE Texts, das in oberen 
linken Ecke des Fensters 
dargstellt wird. 


me 


Return-Wert : keiner 
Kannsannnennnnnreenen nennen 


void HipiScrollRight( BYTE spalte, BYTE zeile ) 


RG VELP Ivelp; /" laufzeiger in den MIp-Tess- Paffer »7 
RG BYTE i, /* Schleifenzähler */ 
starsp; /* Startspalte */ 


Mouidelouse(); /* Maus-Cursor ausblenden */ 


starsp = VL( 1); ". spalte Dereehesn I} 
VioserollRight( starsp, vo(1), VR(-2 nu 3), 1, NOCLEAR ); 
Ivelp = velp + zeile * hi. spalten + spal te - 1; 


I #ie een Zeilen des Fensters durchlaufen 


for 6 
-2 j 35 zeile < hi.zeilen; 
3 ge 
/* Zeichen g: Be B- des HF ausgeben */ 
VioPut( starsp, ji, starsp, i ie); 
aa #= hi.spalten; Zeiger auf nächste Zeile */ 


Hlpikslider Ite-1 ); /" horizontalen Slider anze 2 4 
et je } /" Maus-Cursor wieder Kialeiee 7} 


we 


sHlpiShow 


: Baut den Help-Text innerhalb des Help- * 

Heichgerg ab einer bestimmten Position * 

ett neu auf, ed 

Eingabe-Parameter: Sale = Position, ab der der Help- * 
ZEILE Text dargestellt werden soll * 

rn-Wert : keiner , 


Retu: 
ee 


void HipiShow( BYTE spalte, BYTE zeile ) 


RG VELP Jin /* Laufzeiger in den KOpHTenS-Paffer. ” 
RG BYTE iz, /* Schleifenzähler Zeile */ 
aktz, /* aktue) ie Bildschirmzeile */ 
starsp, /* Startspalte in Bezug auf den B Bildschinn -/ 
ends I* Endspalte in Bezug auf den Bildschirm */ 
starbl, {* Startspalte für Blanks */ 
endb]; /* Endspalte für Blanks */ 


Houki pr /* Maus-Cursor ausblenden ”/ 
Hipik$lider te ); Ir kutsmtalen Slider anzeigen */ 
HIBivslider z. }; /* vertikalen Slider anzeigen */ 
".- Zeiger in Help-Text-Puffer berechnen 

velp » Lt + zei e * hi.spalten + w 
Yen Yı I" tartspalte berechnen * 
eure + , x - 1 <= hi.spalten ) /* Freu? 3) 
Nein 


KuiE . Hal Eh /* keine Blanks 
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else /" 3a, Freiraum am Ende jeder Zeile */ 


a 2 ks Eitjapen den Text an ”/ 
- Ren Eye Endspalte der Blanks */ 


Ir die rare Zeilen innerhalb des Fensters durchl. --*/ 
/* Startspalte berechnen */ 
iz «hf Ar 
e < hi.zeilen 
ae ach) e) 


VioPut( starsp, aktz, endsp, aktz, Ive Pl; 

if ( starb] „ Blanks 0 “4 
Wi tar starbl, aktz, endbl, aktz, col_n ); 

w p + 7 ten; 


( aktz < -3 AR /* Leerzeilen am Dans teren B) 
ae, Ah u tz, vR(-1) „ Wie-3), col_n ); /* Ja 


Noushowlouse(); /" Maus-Cursor wieder einblenden */ 
sHlpSerhf 


ya die resitien des Belp-Fensters 
dschirm sowie seine Größe 


Tr 
Eingabe-Parameter: - = linke Spalte 
YO » obere Zeile 


= ennnnnne 


Return-Wert 


void HIpSethf( BYTE x0, BYTE yO, BYTE x, BYTE y ) 


RG VELP Iv; /* laufzei in Leerzeile */ 
RG BITE ir 9 Chleifenzähler */ 


/* die biergelene: Paraneter in ”/ 
ne 2 ren erenden Vari- ” 


5 


/® Maus-Vektor aufbauen */ 


void HWipißuildwin() 
RG BYTE i; /* Schleifenzähler */ 


Moukidelou UNE /* Maus-Cursor ausblenden */ 
MenkinOpen( AR uf A RAR 


. col_fr }; 
Vioprint( Hl, 7. © aid, [ds It, N 


vol 2); ; 
int( Br i. a u 


VioPrint[souvek[0].x1, mouvek[0].yl, col_bu, OAE* m nl; 
YioPrint/mouvekl1].xi. merk] .yl, col-bu, 
VioPrint|mouve! „x], mouvel .yl, colbu, a 


en /* Maus-Cursor wieder RAR / 


tee 


ıHlpiError 


; year einen Help- 


. 

sch". fehlertext auf, ® i 
Eingabe-Parameter: Pointer auf den Fehler-String * 
Natwra-Nert : keiner s 


: = Die Kresse des Heip-Text-Puffers 
wird in der globalen Variablen VELP * 


BI... RER Nee. 


void HipiError( char * sptr ) 


RG VELP Iv; /* Laufzeiger in den Nelp-Text-Puffer */ 

SYTE  starsp, > Startspa te des Texts */ 
breite; /* Breite des Fensters */ 

RG int en, /* Länge des Fehlerstrings 5) 
Ir /* Schleifenzähler * 


at aus einem einzei- 


hi.zeilen = ( -1i» 2 + 15 /"Text belegt halbes HF*/ 
an e nach erhbesite des HF wird der at zentriert --—-*/ 
breite = len = strien mr... ix-2) 
breite = ( starsp = hin - - len » I ) # len; 
”/* Nein, Fenster schmaler als Text */ 
enge 0; /* Text beginnt in Spalte 0 */ 


hi.spalten = breite; /* Breite des Textes merken */ 
hi.vermise = 0; /* kein Verweis im Hilfstext */ 
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ee Puffer allokieren und zunächst wit Leerz. füll x, 
v= velp = malloc((i = breite * hi. zeiten ® sizeof(VE 1)): 
while ( i-- ) /* den gesamten Puffer durchlaufen */ 


Iv->h.attribut » col „ /" normale Farbe */ 
Iver->h.zeichen = /* ieerzeichen */ 


/*-- den Fehle rstrien durchlaufen und in Puffer schr. ----"/ 
for (Ivevelp+(hi.zeilen-1)"hi.spaltentstarsp ; len-- ; ) 


Iv->h,attribut = col_u; /* Zeichen besonders hervorheben */ 
Ivet->h.zeichen = *sptrrt; /* Zeichen aus Str. kopieren */ 


die, ter auf, 

Eingabe-Parameter: des Help-Texts 

Return-Wert : keiner 

Info : = Die Adresse des Help-Text-Puffers 
Be der globalen Variablen vELp ? 


= DIR Adracne den Vakkers: mit den Ver- * 
weisbeschreibern wird in der Ser globalenı 


Variablen HVDP abgelest. 
.—— / 


void HipiRead( int hnr ) 
Pre, /" 1O-Byte eines INTs */ 


FELL? 


Bp + R| /* HI-Byte eines INTs */ 
ne chen = c, \ 

Da „attribut = aktcol, \ 
+tasp ) 


Kefine Bl a 
#define HI BPTR 
Hefine PUTEhL ©) ( 


li * fehlerstring */ 
En in (denstent ffer */ 
r in 
feige in Vektor */ 

leif 


/* das jeweil / 
/" die Pr ahlvatlerZeichenferde ar 
/* aktuelle 
» Pe aktuelle 
/" taufzeiger in diesen Vektor */ 
/*=- Help-Text im Bei Tent "Vektor, suchen 
vo‘ zn Iptreh‘ len 
Iptr->hn 
Lan Iptr ) : 
Hii=o) nt 
Nein 
sprintf( errstr, "ACHTUNG! Help-Text 4d nicht verfügbar.*, 


HlpiError( errstr ) /* Fehlertext aufbauen */ 
m. urn; /* zurück zum Aufrufer */ 


/*-- Dateizeiger auf Anfang des Bein Tante, innerhalb der --*/ 
/*-- Datei setzen und dann Struktur HI einlesen -. 


sirıhıee Iptr->fpos, SEEK_SET ); 


Start! 
for | 1 = 'sizeof hi, Lu = (BPTR) Abi; i-- ; ) 


“bptrr+ = HipiGetdyte 
if ( ferrorl pP) ) 
sprintf( SHERTIRe 


/" Fehler beim IRSSEIgEER 2% 


! Lesefehler bei Zugriff auf \"ts\*.*, 


hip_ı nam 
KipiError( errstr j: /* fehlertext aufbauen */ 
ap /* zurück zum Aufrufer */ 
Penn Dee für Verweisinformationen alluejeren / 
verweise N bt es Verweise? */ 
% [p = vdp = malloc( hi.verweise * sizeof( VDEF ) ); /"Jar/ 
/*-- Vektor für Help-Text- Puffer allokieren 


aktcol * col_n * Zeichen zunächst in normal 
Iv =» volp « äultoefhi. zeilen * hi.spalten * sizeof ve): 


/*-- die einzelnen Zeichen des Help-Texts durchlaufen 
*0; /* aktuelle Zeile und Spalte */ 
for ( Ye ioirosten - si zeof hi ; i-- ; ) 
er ch( b = Kipißetßyte() ) r Zeichen holen >, 
auswerten *, 
case TOK_UNTER : I" PR unterstreichen */ 
aktcol ® col_u; I" neue Farbe setzen */ 


case TOK_NORMAL : /* normale „Zaichendarstallung Y 
aktcol = col_n; /" neue Farbe setzen */ 
break; “ 

/* Zeichen folgt */ 


tes Zeichen wurde schon gelesen "/ 


Steht Wipeitytet BE 


Bas 
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case TOK LAUNE % /* Zeilenende */ 
aktcol = /* auf normale Farbe umschalten */ 
while | wer m hi.spalten ) I* Rest 8 er sit Ri 


I 
0 /* wieder i Eee ö Sinnen 
gab I" Zeile inkrementieren * 


case TOK_VERWEIS : I" einen Verweis entdeckt */ 
aktcol = col_v; /" Verweis-Farbe */ 
er "0; * Länge des Verweises bisher 0 */ 

Ivdp->spalte - asp; /* Koordinate merken */ 
ie -az; 
/* Leseschleife */ 


7, ; /" ein Byte weni lesen */ 
s Tient b = HipißetByte() ) " Byte Tutwerten */ 


case TOK_CODE : /* Zeichen folgt 4 


++len Verweis-Länge inkrementieren * 
sol Meigerbye() )i 
-j; ® nächstes Zeichen wurde schon gelesen */ 


case TOK_VERWEIS : /* nichts passiert */ 
break; 


defwit : zu jedes andere Zeichen */ 
++len; /* et inkrementieren */ 
‚get b); /® Zeichen in Textpuffer bringen */ 


due | b i= TOK_\ a. 
en = len; des Verweises merken */ 
I vdp->var) = a Ye LO-Byte Verwweis-Nr */ 
u Dem - Nr te /* ki- td Verweis-Nr */ 
0; nächsten fer setzen */ 
\ -. w; zwei Bytes mehr gelesen */ 
akt" "coln; /* auf normale Farbe umschalten */ 


default : /* jedes andere Zeichen */ 
DEN b): f* Zeichen in Textpuffer bringen */ 


———.———— ee 
ı#lpiTracekSlider 
B Ar A horizontalen Slider hinter * 
dem rsor her. 
Eingabe-Parameter: SPTR =» ir u Variable wit akt. Spalten 
ZPTR = Ptr auf Variable mit akt. Zeile * 1 
Return-Wert : keiner e y 
void KipiTracetSlider( BPTR sptr, BPTR zptr ) 
RG int_ even {* Maus-Ereignis */ 


RG Brte s It, /* Spalte, in der sich die Haus ai gu wg: 
Balsı au /* neue Spalte */ 


) 
: 


ne - Ale 2 + hslider ); /" aktuelle Slider-Spalte */ 
/" Abfrageschleife */ 
fr Mair Talk "/ 
. Brest EV_MOU_MOVE | EV AR 
if rk event & EY_MOU ) er derart J 


ut Pr 


a A Es )) 


s von Slider-Box */ 


/* Maus rechts von Slider-Box */ 
if ( newsp ie spalt » /* Verä eh 
H ( newsp I» spalte ) ndergest 


us-Cursor ausblenden */ 
Vioprint( VLlE YL{2shslider), we) 2 _s], FALSE, "P): 


ider L 
DIOREinet vL NRatider), Wv(-2). col_sl, FALSE, * * ); 
MouShomlouse(); Maus-Lursor "wieder anzeigen */ 


spalte » #; Ri neue Spalte merken */ 


else /* Vinker Aunise f wurde losgelassen */ 
break; /* WHILE-Schleife beenden */ 


nbinsitde Kay: 0): MA= R) URL aaaat eie als HF? B 
a“ : oe durch Ver een =/ ./ 


if ( spalte »- vR( -2 ) r ar. Rand d. Slider- - “ 
spalte = hi. ar pn 

else ee te zu "st er-Positi aa are 
eelte - Aatider * (bi.spalten - M, ar 8 ‘ (hf_x - 5): 
WipiShow( *sptr = spalte, *zptr ); neu aufbauen * 


nernenennnnenen nennen 
ee est 
t Een Yarkı lalen Slider hinter 

0 * 
Eingabe-Parameter: SPTR = x er Variable wit akt. Spalte* 
ZPTR = Ptr auf Variable wit akt. Zeile * I 

Return-Wert : keiner 
een 


.... n 
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yr HipiTracevSlider( BPTR sptr, BPTR zptr ) 


RG int event; /* Maus-Ereignis */ 
RG BYTE zeile, /* Zeile, in der sich die Haus befindet */ 
newz; I" neue Maus-Zeile */ 


zeile = .. + vslider ); /* aktuelle Slider-Zeile */ 
while ( TRUE ) /* Abfrageschleife */ 
i* Dermemer raten 74 


KbmEventWait( EV_MOU_MOVE | EV_LE\ 
ler event a EN Mu A es "borsır % 


2 an ‘ «vol 2 tn) it a über Slider-Box */ 


Ki (new > w( -4) ) a 
newz = WU -4 ); /* Maus unter Slider-Box */ 


if ( newz I» zeile ) ” MARIN ’ 


zeile = Fo neue Zeile merken “ 
Houli il 3 ausblenden */ 
Merrintl. YR(öj, ae Col _SI.PALSE, Pe): 


vslide 
Hobrined, R ri). w 2+vslider), col_sl, FALSE, " * ): 
® Haus-Cursor wieder anzeigen */ 


di /* Yinker x f wurde losgelassen „ 
break; /" WHILE-Schleife beenden * 


(‚hi.zeilen < hf_y - a) PP Text kürzer als HF? */ 
nonsitäer 2 ); /* Ja, My Rseyg ını Meran eren “ 
ee eilamssitiee durch 


ehe EL 14 -4 Lies Pe Y u, Rand d. Stidan Dont 2 


e=hi. ni: rg 
ir aus % Üser-Position berechen “ 
sale BR hirzeilen - Ar y.+ RAUM 
piShom( *sptr, *zptr = zeile ); /* He Aa neu Hg ”/ 


) 
LEE 7 .. 


I 2. funktion 8 ®. 
DL 


: Läd Help- auf 
dem Bildschirn an und en die 
Ei ap honch von Aa gr Tastatur. 


“ 
* 
“ 
Eingabe-Parameter: HNR BulezTenes “ 
Return-Kert : Mamsar. Pen ae Help-Texts oder 0, bu 

” 

/ 


” 
" wenn kein Help-Text mehr zeigt 
’ werden soll. an 


LEI TTZ ee 


int HipiProcess( int hnr ) 


4define SUCHY( v, ©) npieuehet v, 0, spalte, zeile } 
4define COLY( v, ce ) HipiColorV( v, c, spalte, zeile 


RG VOP Ivdp; /* Zeiger in Verweis-Vektor */ 
BYTE i, * für diverse Zwecke */ 
spalte, % Zerchang innerhalb des Help-Texts, das */ 

Beate in der oberen linken Fenzterache, steht */ 

ns /* neue Spalte */ 

nz /* neue Zeile */ 

ni, /* Anzahl Help-Zeilen im Fenster */ 

anzsp, /* Anzahl Palp; Spalten im Fenster */ 

aktver, /* aktueller Verweis */ 


ou: 
RG int 
/* nächster Belstant 
TASTE n /* Zeichen von der Tastatur 
BOOL de; 
Hl een er ‚ /* Kelp-Text einladen & dekodieren 
nftnstede /* die beiden Slider initialisieren 
Iniersiaen 
/* Mausbereich zurücksetzen 
Peer ” -4; /" Anzahl sichtbarer Help-Zeilen 
Fer ng - h 1-2; /* Anzahl sichtbarer Help-Spalten 


aktver = KEIN VERWEIS; /* noch keinen aktuellen Verweis 
HipiShow( nexthp = spalte = zeile = 0, 0 ); 


Irnn Intereköignsschteife 
while ( ende ) 


if ( aktver == KEIN_VERWEIS Im /" z.2t kein Verweis? 
Nein, einen Verweis suchen 
aktver = SUCHV 


if ( aktver Ne Eh VEReE VERWEIS j /* Verweis gefunden? 
COLV( aktver, col_a ); I" 


else /* aktueller Verweis noch im Fenter? 
if ( IMIpiViF( aktver, spalte, zeile ) ) je 


COLV( aktver, col_ v ); /" wieder Verweis-Farbe wen 
neuver = SUCHV( aktver, $ 2 Ye; 

if ( neuver == KEIN_VE 

aktver = SUCHY( aktver, s }; /* Mein, Acht, s.*/ 
else /* es würde ein Ai gefunden */ 
aktver = neuve Tal des nei erweises ” 
if f aktver I= KEIN. VERWEIS ) 7" jetzt einen Verweis? */ 
} COlv( aktver, col_a ); /* Ja, markieren */ 
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t = KbuEventWait LEFT_PRESS | EV_KEY_AVAIL 
Bi rg event & EV_KEY_ hut WAIT ) = E yaate Alalior “ 


Ja, Taste auswerten */ 
ER key = Kbdßetkey() ) 


/* 


if ite .- 

RS Ee - ae 0,0): 
ne ei; h 
Bi hi. zeiten <anzl ) 


vw = hi. ee ual: ar 0) 
E nz] == zeile spalte == 
‚nis ( spalte = 0, le» nz! ); 


case CDOWN : /* 

in lzeiles ” za zellen I; 
ro s . zeilert ); 

breik: Rn 


Er 
TE spalte, zeile-- ); jr ” 


Ey CLEFT : /* Cursor Left ”/ 
if ( spelte ) * Spalte noch nicht mE oe, 
Bin ige zeile ); /" Nein 


a IaE> 3 I" Cursor Right */ 
f ( spalte + anzsp < hi.spalten 
„MpjSeroiftertl spalte++, zeile 


I" Page-Down */ 
Ar (een zeile +anzl + anzl < hi. 
HIpiShow u | zu += anz] };, /" PgDn mögl. 

else nicht möglich, Textende anz. BY 
Mpishonl a re zeile = hi,zeilen - anz] ); 


se CPGUP 
KH ( zarie: >= anz) ) 
HIpiShow( spalte, zeile -= anz] 
else /* Page-Up en 
ru, spalte, zeile = ; 


id nächsten Verweis */ 
“ir ” a i= KEIN_VERWEIS )  /" Verweis im Bus 4 


neuver = aktver; /* neuer Verw. ist auch alter */ 
if (beiverslehvakıyer. 37000) == KEIN_VERWEIS) 


if { neuver I= aktver E& neuver != KEIN_VERWEIS ) 
/* neuen Verweis gefunden */ 
COLY( aktver, col_v )i Me alten Verw. ausbl. */ 
COLV| aktver = neuver, col_a ); 


break; 


case BACKTAB : dee zen? Verweis */ 
“7 ( aktver I= KEIN! verteis Y Verweis vn m: % 
YRR 
neuver = aktver; /* Verw. ist auch alter */ 
if nseresgchyfaftens S "PRe0) == KEIN_VERWEIS) 
neuver = SUCHY( hi. verweise, S_PRED 
if ( neuver I» aktver neuver != K in. VERWEIS } 
neuen Verweis gefunden 2) 
COLY( aktver, col_v ); /* Yeeilten Verw. ausb]. 
COLV( aktver = neuver, col_a ); 


break; 


case Fl: Hilfe über Hilfe “4 
ende = TRUE; /* Funktion 
pthe = KILFE_TEXT; /" Nummer des Help-Texts MN 


case ALT_FI: /*-- letzten Hilfstext anzeigen "/ 
ende = TRUE; * Funktion n 
peathe . LAST_| HT; /* Konstante: "letzten Help-Text* */ 


case CR: Hilfstext anwählen */ 
ende = TRUE; 
nexthp=(aktver==KEIN VERWEIS) ? O : (vdptaktver)->unr; 
break; 
Hilfe verlassen */ 
/" keinen Help-Text mehr anzeigen */ 


f /* Yinken Mausknopf niedergedrückt 

switch ( MouGetßBereich() ) /* Mausbereich auswerten 
case 0: Te Beete 
ende = TRUE; I" tion beenden */ 

DENE = HILFE_TEXT; /* Hilfe De Mile anzeigen 
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BEER en Verweis-Button e 


ende = /* Funktion 
BecthpelaktrernnkEi. VERWEIS) ? 0 : m HE Fr nl 


Escape-Button */ 
/* Funktion beenden */ 
/" keinen Hilfstext mehr anzeigen */ 


ana pre des Help-Texts * 

n le ; /* Text-Zeile e 
mous = MoußetCol() - ve Ite; /"Text-Spalte*/ 
ag befindet sic Sur ) u einem Verweis?---- */ 

i=hi.verweise, Ivdp = a pi i; +rlvdp, --i ) 

wouz == Ivdp->zeile 88 
wous >= Ivdp->spalte 58 
mous < 1vdp->spalte + hie 3 len ) 
break; Verweis gefunden */ 
it (il /* wurde Ru Verweis ad ya “ 


nexthp = Ivdp->vnr; /"Nummer des nächsten H-Text*/ 
ende = TRUE; /* Funktion beenden */ 


case 3: 
Ren 


break; 


case 4: ! Pfeil links */ 
if ( spalte ) /* Spalte noch nicht Null? */ 
MIEFSSrStIRIgREN spalte--, zeile ); /* Nein */ 
reak; 


case 5: horizontaler Slider */ 
3 = MoußetCol() - FM /* rel. Position 
iflie< el her) ) /* Yinks vom Slider? 
Ja, ‚dentisch wit Pfeil-links 

f ( spalte ) " Spalte noch nicht Null? * 

ee Rlaned spalte--, zeile ); /* Nein 


/* rechts vom Slider? 


else 
if(i> USE: ) 
identisch mit Pfeil-rechts 


f ( spalte + anzsp < hi.spalten 
tee spalte++, zeile 


/* auf dem Slider */ 
„pi TraceNStider( &spalte, teile ); 


“. 6: die Pfeil rechts 
f ( spalte + anzsp < hi.spalten 
‚MpiSeroiftart spalte++, zeile 


/ Pfeil oben 
“r ( zeil ) /* Zeile noch nicht Hull? 
roll ( spa] /* Nein * 


Ele te, zeile-- ); 


area Slider 


re). 
Ir ie) i< Fern) \ I" Pr Pa) Stider? 
, en wit Pfeil-oben 
if ( ze le noch nicht Null? 
We Tode spalte, ti ); /* Nein 


/* unter dem Slider? 


ir (i> a 

{ ja re ti nit Pfeil-unten 
if ( zeile + anz] < hi.zeilen 
HipiScrollup( spalte, zeile+ ); 


/* auf dem Slider */ 
ihren &spalte, &zeile ); 


Pfeil unten 
wieter scrollen? 
I" Ja 


Rn MouGetBereich() ):i /* Maus-Verzögerung 

) 
/*-- die in KipiRead allokierten Puffer wieder freigeben --*/ 
if ( hi.verweise ) /* gibt es Verweise? */ 
free( vdp 5 I" da */ 
free( velp ); 


HIpiHSlider ; 
noise o ji 


ae nexthp; /* Nummer des nächsten Help-Texts zurückl. ”/ 


/* die zwei Slider ausblenden */ 


EEE EEE 


5. Funktion 


Steuert den Aufbau eines Help-Texts 
sowie die “.Auiregs von Maus & Tastatur, * 
* Eingabe-| „Parameter: HNR s Help-Texts = 


* Return-Wert : kei Ba ” 
|; Ausannnnnneranstaneenennnnnanennnnenen / 


void HlpShow( RG int hnr ) 


Morburiantell; /* Maus-Parameter sichern */ 
HipiBuildWin /* Help-Fenster aufbauen */ 
MouSetBereich "ELVEK( wouvek ), mouvek ); /"Mausber. setzen*/ 
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do 


In. Platz im Hei ‚Neck ar 
wemove( Änstackfä Je Mi [%}. 

sizeof I - rix a R ): 
hstack[0] = har; 


ker - Kipifrocest( har ); /* Help-Text anzeigen */ 
( har == LAST_AT ) /* letzten Help-Text aa */ 


har = hstack[1}; /* Help-Numser aus Stack holen */ 
/*-- Help-Stack um eine Position nach vorne schieben --*/ 
nemmove( Pühtacifo], 8 ee 5 

sizeof ck ER = a hstack[0] ) ): 
aan ANZ_MERKE-1 ] = 


-Nummer merken */ 


dire ( har ); 


Woukidelouse(); /* Maus-Cursor ausblenden */ 
MenWinClose( TRUE ); /* Help-Fenster schließen */ 
KouShowlouse(); /* Waus-Cursor wieder anzeigen */ 
0 /* Maus-Parameter zurückholen */ 


Ten 


: leitet die Arbeit mit dem Help-Hodul 
ER legt den Namen der Help-Datei 
est. 
Eingabe-Parameter: HNPTR : Pointer auf einen sing; der 
den Namen der Help-Datei ent- 


t. 
Return-Wert : TRUE, wenn die Datei vorgefunden und 
einwandfrei initialisiert werden konn- 
te, sonst FALSE 


a 


wuninnnnnen 


800L HipInit( char * hnptr ) 


RG int ven, /* Länge des WEDRNLISEE “/ 

” ri y* Zi in den Help-Stack */ 
BYTE /* schleifenzähler “/ 
struct vonder kopf; /* Kopf der Help-Datei */ 


fi hip_nam = hnptr, "rb" .- WILL 
ar (, ist ve Ir Datei Bent nich Dart 2ER 


if ( fread( &kopf, sizeof kopf, 1, fı ie] 
En er ” bu Kopf a Ik eis werden 


if ( kopf. on != 1D_CODE ) /* Nelp-Datei? 
return FAL /* Nein, Code nicht gefunden 


htanz = kopf .anzahl; /* Anzahl der Help-Texte merken 

HN tr = malloc( vien = Ense } n ) * sizeof( HCD ) ); 
FT fread( hti_ptr, 1, v fr) I= vlen 

nr FALSE; I" Vektor onnte nicht gelesen werden 


HipiBuildTree( &baum ); /* Codebaum aufbauen 


/*-- Help-Stack initialisieren 


for ( i = ANZ_MERKE+1, er = hstack; i-- 
*hstptr++ = STACK_EMP 


/*-- Farben für die verschiedenen Zeichen festlegen 
if ( ViolsColor() ) /" im Color-Hodus? 


I" Ja 

/* normaler H-Text 

/* Nerweis 

/* aktueller Verweis 

/* unterstr. H-Text 

HIDSCFrane a h ); /* Rahmen um HF 
UDSCRSEL 60L /* Buttons 
HIpSCSTidt ers st ur /* Slider 


‚MÄRSERFeBIE coL_PF ); /" Pfeile an Slidern 
else /* im monochrom-Modus 


/* Ja 
er) N); /* normaler H-Text 
/* Verweis 
MOR A ; /" aktueller Verweis 
U /* unterstr. H-Text 

* Rahmen 


MoScsTi { HOR SL i yr sti 
Na pSCPfeil( MOR_ Pr) /* Pfeile an Slidern 


HipiBuildMouvek(); /* Maus-Vektor aufbauen 
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HLPDEMO, & 
En -- 3 : Aufbau einer Help-Datei 


w 


Aufbau einer Help-Datei 


Eine Help-Datei, wie sie dem Program »HLPCOMP« zur 
il; wird, muß ein bestimmtes Format 
isen, damit ihre Bestandteile von »HLPCOMP« erkannt und 

verarbeitet werden können. 


Die einzelnen Help-Texte müssen dazu in aufeinanderfol 
Zetien eg Jene o.., ker Zeile 
einem Doppelpun 
die Nummer 


: 4 ARE Hu) „ıipose: s u. c 


dinclude *"vio. % /* die SAA-Include-Dateien einbinden "/ 
finclude "kb 
#include *hlp. h 


/*== Hauptprogramm =*/ 
void main( int argc, char "argv[] ) 
Violnit } /* Video-Modul initialisieren */ 


rden. Diesem 

e des eig-tets () Are dezimaler Form) 
sind Kennummern a Bin wobe r 
Kein-Ten eine AMENIOBTE u tra: Haren Bis auf die 
Forderung, dı BR HBIRTORE 1 grundsätzlich Informationen 
über die Arbeit mit der Hilfe-Funktion enthalten muß, 
unterliegt die Numerierung der Help-Texte keinerlei 
Ristriktionen. 


Innerhalb der Alanlpas Help-Texte kennzeichnen verschiedene 
\vSteverzeichen\vd. die Verweise auf andere Help-Texte sowie 
bestimmte Farbattribute. 


Jeder Help-Text kann eine beliebige Anzahl von 
Kommentarzeilen enthalten, die jeweils durch ein Semikolon 
eingeleitet werden. 


\xil\v... über die Help-Engine\v2.\x10 \xil\vDemo-Seite\v5.\x10 


Kbalnit(); /* Tastatur- und Maus aigagn NAnSHELIFIREEN Kee 
VioClear ereen( Violscolor() ? COL( WE BLAU ) : INVERS ); 
Hou‘ /* Maus-Cursor ee ie; 
Ip" /* Help-Hodul initialisieren */ 
r „2 anzeigen */ 
nicht gefunden *, 
Fehlende oder falsche Help-Datei.\n*); 


: Steuerzeichen innerhalb einer Help-Datei 


Listing 5: HLPDEMO.C 
Steuerzeichen innerhalb einer Help-Datei 


Der Help-Compiler erkennt verschiedene Steverzeichen, die an 
jeder beliebigen Stelle innerhalb eines Help-Texts 
angebracht werden können und ihm Nachricht über Verweise und 
Farbattribute liefern. Folgende Steuerzeichen werden 


i HLPDEMO.TXT eine le Tues-) Datei 
erkannt: 


; (c) 1989 by MICHAEL 

K 1 : grundsätzlich Pipe über Hilfe 

: Hilfe über Hilfe \\v leitet einen Verweis ein 

\\vk. beendet einen Verweis, wobei N die Nummer des Help- 
Texts angibt, auf den verwiesen wird 


\\u SARBESEIGIEEE die el ersagn Zeichen auf einem 
sonochromen Monitor bzw. sie auf einem Color- 
Monitor farblich Erna s Mer 


\\n stellt die nachfolgenden Zeichen wieder in ihrer 
normalen farbe dar 


| Sofern der Help-Text ist als 
! a Help fenster I , ich 
\xib | 5 | \xla | der sichtbare Ausschnitt "des Help- 
Texts mit Aue der Cursor-Tasten 
verschi 


ai“ zum je- 


Lerl[e]e bringt den zuletzt betrachteten Help 
Text wieder zurück 


\xı1 | holt den aktuell markierten Verweis auf 
den Bildschirm 


Lese] zurück zum Programs 


I\v... über die Help-Engine\v2.\x10 


\\ ein normaler Backslash 
\\xhh Zeichen mit dem hexadezimalen ASCII-Code hh 
\xil\v... über die Help-Engine\v2.\x10 \x11\vDemo-Seite\v5.\x10 


; -- 5 : Demo-Seite 
is 


Demo-Seite 


Dieser Help-Text zeigt Ihnen verschiedene Möglichkeiten zur 
Gestaltung eines Help-Texts auf. 


1.e 2: SEEN) wenn der Help-Stack leer ist 
i über die SAA-Help-Engine 


Sie Kos N An wit 
rafik mischen u 
Das Hei ul bietet Ihnen im Rahmen der SAA-Serie die ffek 1 
mualtchee it, sellenige Help-Texte zu erstellen und sie in EN ee ENLNR 
Ihre SAA-Applikationen einzubinden. Mit Vergielchsueise 
geringen Aufwand können Sie dem Anwender dadurch den Komfort 
pretensioneller Anwendungen bieten. Der Entwicklungsprozef 
umfaßt dabei nur ganze vier Schritte: 
Sie können Zeichen besonders \uhervorheben\n. 


Und Sie können Verweise anbri damit der Anwender 
auf Wunsch Hilfe-Informationen Über ein anderes Thema 
erhalten kann. Dieser SUERTIBLANNE: allerdings führt ins 
Leere, nämlich zum Help-Text mit der Nummer 6, der 
innerhalb dieser Help-Datei nicht implementiert wurde. 


= Erstellen Sie die verschiedenen Help-Texte innerhalb 
einer Help-Datei wit einem beliebigen Editor oder 
Testverarbeitungsprogram am und $ Bien Sie diese Datei 
als unformatiertes ASCII-File a 


= Kompilieren Sie diese Nede wit Hilfe des 
Programms »HLPCOHP« und bringen Sie sie dadurch in ein 
für die SAA-Help-Engine lesbares Format. 


ie Sie einen Aufruf der Funktion AEpReiEL 
einame)« in den Startcode Ihres Programms an, u 
rufen Sie bei der Betätigung der entsprechenden Help- 
ds TmesraRıE Ihres Programms die Funktion »H PSho 

Rh auf, um den Help-Text mit der Nummer »Nr« auf den 
Bildschirm zu holen. 


= Kompilieren Sie das Hel ul »HLP.C« und verbinden 
Sie es mit den anderen SAA-Moduln und Ihrem Programm. 


\x11\vAufbau einer Help-Datei\v3.\x10 \x11\vDemo-Seite\v5.\x10 


u dumm dumm dann Dunn Dumm dm nn Dann Damm Dan Dam Dam Dan Dam Dun Dan Dan Dan Dann Dann denn 
Dann Dunn Daun dann den 


ein Help-Text kann übrigens auch wesentlich breiter als das 
Help-Fenster sein 


\xil\v... über die Help-Engine\v2.\x10 


Listing 6: HLPDEMO.T Listing 6: (Ende) 
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hneller, leistungsfähiger und komfortabler: 


Das neue QuickC 2.0 


Immer mehr Programmierer haben sich in den 
letzten Jahren von der Leistungsfähigkeit der 
Programmiersprache C überzeugen lassen und 
sind dazu übergegangen, PC-Applikationen in 
dieser Sprache zu entwickeln. Damit ist auch die 
Nachfrage nach leistungsfähigen und vor allem 
komfortablen Entwicklungsumgebungen gewach- 
sen, die den Programmierer bei der Programm- 
entwicklung in optimaler Weise unterstützen. 
Microsoft kommt diesem Trend entgegen, indem 
es dem Programmierer mit QuickC 2.0 eine Ent- 
wicklungsumgebung an die Hand gibt, die keine 
Wünsche mehr offen läßt. 


Wer die Programmiersprache C kennt, der weiß, daß diese 
Sprache hohe Anforderungen an die verwendeten Ent- 
wicklungswerkzeuge stellt. Dies beginnt bereits mit dem 
Befehlssatz, der sich auf ein Mindestmaß an Befehlen zur 
Programmsteuerung beschränkt und alles Weitere einer 
sogenannten Library (Funktionsbibliothek) überläßt, die 
dem Programmierer zahlreiche Funktionen aus den Berei- 
chen Ein-/Ausgabe, Speicherverwaltung, Fließkommaarith- 
metik etc. zur Verfügung stellt. Da es sich bei C um eine 
kompilierte Sprache handelt, ist der Programmierer auf 
einen schnellen Compiler und Linker angewiesen, damit 
seine Produktivität nicht zu sehr unter langen Überset- 
zungsläufen leidet. Dabei darf jedoch die Optimierung des 
Programmcodes nicht zu kurz kommen, denn C bietet dem 
Compiler durch seine einfache Struktur eine ganze Reihe 
von Möglichkeiten, den erstellten Maschinencode zu opti- 
mieren und dadurch die Ausführungsgeschwindigkeit eines 
Programms zu steigern. Dies alles sind Leistungsmerkmale, 
nach denen ein traditioneller C-Compiler üblicherweise 
beurteilt wird. Doch QuickC ist mehr als nur ein C-Compi- 
ler, vereinigt es in sich doch eine komplette Entwicklungs- 
umgebung mit Editor, Make-Utility, Compiler, Linker, 
Debugger und einem ausgefeilten Hilfe-System. 


Die Entwicklungsumgebung von QuickC 


Wenn auch die verschiedenen Komponenten wie Compiler 
und Linker als eigenständige Tools von der DOS-Oberflä- 
che aus aufgerufen werden können, so entfaltet QuickC 
seine ganze Leistungsfähigkeit doch erst im Rahmen der 
integrierten Entwicklungsumgebung, in der die verschie- 
denen Tools unter einem Dach vereinigt und miteinander 
verknüpft werden. Dem Anwender präsentiert sich dabei 
eine Benutzerschnittstelle, die ganz nach den Richtlinien 
des SAA-Standards geformt wurde und mit dem Anwender 
über Fenster, Pull-Down-Menüs und Dialogboxen in Ver- 
bindung tritt (Bild 7). Alle Funktionen sind dabei leicht 
über die Tastatur zu erreichen, doch ist auch die Maus in 
die Bedienung der Oberfläche voll integriert. 
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Bild 1: Die Benutzeroberfläche von QuickC folgt ganz den 
Richtlinien des SAA-Standards. 


Im Mittelpunkt der Benutzeroberfläche steht das Haupt- 
menü, über das Sie alle Befehle innerhalb der Entwick- 
lungsumgebung erreichen können und das Dateifenster, in 
dem jeweils eine Datei editiert wird. Um Anwendern, die 
bisher mit einem anderen Editor gearbeitet haben, entge- 
genzukommen, kann der QuickC-Editor beliebig konfigu- 
riert werden. Im Lieferumfang sind dazu vier vordefinierte 
Tastaturtabellen enthalten, die die 50 Funktionen des Edi- 
tors auf verschiedene Tastenkombinationen abbilden. Und 
wer sich mit diesen vordefinierten Tabellen noch immer 
nicht zurechtfindet, der kann sich mit Hilfe des beigefügten 
Programms MKKEY eine eigene Tastaturtabelle erstellen. 

Aber auch Anwender, die nicht auf ihren gewohnten 
Editor verzichten möchten, müssen auf den Komfort der 
QuickC-Entwicklungsumgebung nicht ganz verzichten. Mit 
Hilfe eines Menüpunktes innerhalb des Optionen-Menüs 
können neue Menüpunkte in dieses Menü aufgenommen 
werden. Sie werden mit dem Aufruf eines beliebigen DOS- 
Programms - z.B. eines Editors - verbunden, so daß der 
Aufruf des jeweiligen Menüs die Ausführung des damit ver- 
bundenen Programms (bzw. DOS-Befehls) zur Folge hat. 

Über einen weiteren Menüpunkt innerhalb des Optio- 
nen-Menüs wird dem Anwender nun auch die Möglichkeit 
geboten, zwischen einer Einsteiger- und einer Profi-Version 
von QuickC umzuschalten. Zwar sind auch in der Einstei- 
ger-Version alle QuickC-Optionen und -Befehle weiterhin 
vorhanden, doch werden nur noch die wichtigsten von ihnen 
innerhalb des Hauptmenüs und dessen Untermenüs ange- 
zeigt, so daß auch nur sie vom Anwender aufgerufen wer- 
den können. Dadurch soll gewährleistet werden, daß sich 
der Einsteiger bei seiner Arbeit mit QuickC leichter 
zurechtfindet und erst nach einer Einarbeitungsphase mit 
allen Möglichkeiten von QuickC konfrontiert wird. 

Dem SAA-Standard folgend verfügt QuickC über ein 
kontextsensitives Hilfe-System, das jederzeit durch 
Betätigung der Taste erreichbar ist und auf fast jede 
Frage eine Antwort hat. Der Begriff »kontextsensitiv« 
bedeutet in diesem Zusammenhang, daß QuickC bei der 
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Bild 2: Das Hilfesystem von QuickC bietet u.a. einen Hilfe- 
Index an, in dem die Themen aller Hilfeseiten in alphabeti- 
scher Reihenfolge aufgeführt werden. 


Suche nach einem geeigneten Hilfstext auf die aktuelle 
Situation eingeht, aus der heraus der Anwender Hilfe 
angefordert hat. Wenn Sie sich also z.B. innerhalb des 
Hauptmenüs oder eines Untermenüs befinden, so wird 
Ihnen QuickC Hilfe-Informationen zu dem jeweiligen 
Menüpunkt anbieten und Ihnen so z.B. die Aufgaben dieses 
Menüpunktes vor Augen führen. 

Gleiches gilt auch, wenn Sie sich innerhalb einer der 
zahlreichen Dialogboxen befinden, die nach dem Aufruf der 
verschiedenen Befehle aus dem Hauptmenü erscheinen. 
Auf Anfrage wird Ihnen QuickC dann nicht nur Informatio- 
nen über die Aufgabe dieser Dialogbox und ihrer einzelnen 
Felder, sondern auch über die Bedienung, d.h. das Springen 
zwischen den einzelnen Feldern, die Dateneingabe etc., 
anbieten. 

Etwas anders geht das Hilfesystem allerdings vor, wenn 
Sie aus dem Dateifenster heraus Hilfe anfordern. Dann 
nämlich sucht das Hilfesystem nach Informationen im 
Zusammenhang mit dem Begriff, auf dem sich der Cursor 
gerade befindet. So können auf diese Art und Weise bei- 
spielsweise Informationen über eine der zahlreichen Biblio- 
theksfunktion eingeholt werden, indem der Cursor auf den 
Namen dieser Funktion innerhalb eines C-Programms be- 
wegt und dann die Hilfe-Taste betätigt wird. (Alternativ 
kann auch der Maus-Cursor auf einen bestimmten Begriff 
bewegt und dann der rechte Mausknopf gedrückt werden.) 

Auf dem Bildschirm erscheint augenblicklich eine Hilfe- 
seite, in der alle Informationen über diese Funktion 
(Aufgabe, Übergabe-Parameter, Return-Wert, zugehörige 
Include-Datei etc.) aufgeführt werden. Zusätzlich hält das 
Hilfesystem zu jeder Funktion aus der Laufzeit-Bibliothek 
auch ein kleines Demo-Programm bereit, das den Einsatz 
dieser Funktion im Rahmen eines Programms verdeutlicht. 
Wie auch jeder andere Text innerhalb einer Hilfe-Seite, so 
können auch Teile dieses Listings dirckt in Ihr Programm 
kopiert werden. In bisherigen QuickC-Versionen mußten 
viele dieser Informationen mühsam in einem speziellen 
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Verzeichnis der Funktionen aus der Laufzeitbibliothek 
nachgeschlagen werden. Dies ist nun nicht mehr notwendig, 
da alle diese Informationen im elektronischen Hilfe-System 
zu finden sind, und man hat sich bei Microsoft daher sogar 
entschlossen, die gedruckte »Referenz der Laufzeitbiblio- 
thek« nicht mehr mit QuickC auszuliefern. 

Neben kontextsensitiven Informationen kann man über 
das Hilfesystem aber auch an allgemeine Informationen 
gelangen. Zu diesem Zweck gibt es im Hauptmenü einen 
speziellen Menüpunkt, der auf allgemeine Themen rund um 
QuickC und die C-Programmierung verweist, sowie einen 
Hilfe-Index (Bild 2), in dem die Themen der Hilfeseiten in 
alphabetischer Reihenfolge aufgeführt werden. 


Der QuickC-Compiler 


Der QuickC-Compiler ist in der Version 2.0 voll kompatibel 
zu Microsofts großem C-Compiler (MSC) der Version 5.1, 
kann im Gegensatz zu diesem aber noch nicht im Protected- 
Modus von OS/2 betrieben werden. Dafür unterstützt er 
aber die neuen Funktions-Deklaratoren, die mit der Ver- 
sion 5.1 eingeführt wurden. Im einzelnen sind dies 
_export (für die Windows-Programmierung), sowie 
_saveregs und loadds, die hauptsächlich bei der Pro- 
grammierung von Interrupt-Handlern in C zum Einsatz 
kommen. 

Durch interne Optimierungen und den Einsatz einer 
neuen Technik, des sogenannten »inkrementalen Kompilie- 
rens« konnte die Kompilierungsgeschwindigkeit des 
QuickC-Compilers gegenüber seinen Vorgängerversionen 
noch einmal deutlich gesteigert werden. Dabei verbirgt sich 
hinter dem inkrementalen Kompilieren eine recht einfache 
Idee, die auf die Art und Weise vorgeht, wie die meisten 
Programmierer ihre Programme entwickeln. 

In der Regel vollzieht sich diese Entwicklung nämlich 
Schritt für Schritt (bzw. Funktion für Funktion), wobei der 
Programmierer das Programm nach der Erstellung jeweils 
einer logischen Einheit von Funktionen übersetzen läßt und 
die einwandfreie Ausführung der Funktionen dann aus- 
testet. Dadurch aber muß in der Regel nicht das komplette 
Programm neu übersetzt werden, denn viele Funktionen 
wurden seit der letzten Kompilierung nicht verändert und 
resultieren deshalb auch nicht in neuem Maschinencode. 

Dieser Idee folgend kompiliert QuickC bei jedem Über- 
setzungslauf tatsächlich nur die Funktionen, an denen seit 
der letzten Kompilierung Änderungen vorgenommen wor- 
den sind. Um welche Funktionen es sich dabei handelt, 
erkennt der Compiler anhand einer sogenannten »Module 
Description Table« (einer Datei mit der Erweiterung MDT), 
die er bei jeder Kompilierung einer Quelldatei anlegt bzw. 
ergänzt. Eine Ausnahme bilden dabei lediglich Änderungen 
an den globalen Variablen, die in der Regel Veränderungen 
in fast allen Funktionen nach sich ziehen. Da der Compiler 
diese Veränderungen nicht so ohne weiteres nachvollziehen 
kann, wird in diesem Fall die komplette Quelldatei neu 
kompiliert. 
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Ps Cls( unsigned int VioSeg, unsigned char Farbe ) 


/*-- hier können beliebige C-Befehle stehen 


_asım /* es folgt ein Assembler-Block %/ 


{ 

mov ;DI darf nicht verändert werden 
mov ;übergebene Segmentadresse nach ES 
mov b ;‚Farbe nach AH 

nov al, ;ASCII-Code 

mov ;d. Bildschirm umfapt 2008 Zeichen 
xor di,di ‚am Anfang des Video-RAM beginnen 
rep ‚den Video-RAM mit AX füllen 

gr ‚Inhalt von DI zurückholen 


/*-- hier können beliebige C-Befehle stehen 
} 
void main( void ) 


Cls( OxbAdd, 28x79 ); /* monochromen Video-RAM löschen */ 


Listing 1: Dieses Programm verdeutlicht die Einbindung von 
Assembler-Befehlen in ein C-Programm. 


Treten bei der Kompilierung Fehler auf, öffnet QuickC 
auf dem Bildschirm ein spezielles Fenster, in dem alle Feh- 
lermeldungen des Compilers aufgeführt werden. Während 
man mit Hilfe einfacher Tastenkombinationen von Fehler 
zu Fehler springt, zeigt QuickC im Dateifenster automatisch 
die Zeile innerhalb der Quelldatei an, in der der Fehler 
aufgetreten ist, so daß man den Fehler direkt korrigieren 
kann und sich nicht mühsam durch die Datei »blättern« 
muß. 


Assembler-Befehle in C-Programmen 


Eine weitere Neuheit stellt die Fähigkeit des QuickC-Com- 
pilers dar, Assembler-Befehle innerhalb eines C-Pro- 
gramms zu assemblieren und direkt in den C-Code zu inte- 
grieren (Listing I). Über das neue Befehlswort _asm 
können dabei beliebige Assembler-Sequenzen in den Quell- 
code aufgenommen und während der Kompilierung direkt 
in Maschinensprache übersetzt werden. Diese Vorgehens- 
weise empfiehlt sich besonders bei kleineren Assembler- 
Routinen bzw. -Sequenzen, da dadurch nicht auf einen 
speziellen Assembler zurückgegriffen und die QuickC- 
Umgebung nicht verlassen werden muß. 


Der QuickC-Linker 


Auch im Hinblick auf den Linklauf und den ihm zugrunde 
liegenden Linker hat sich gegenüber der Vorgängerversion 
einiges verändert. QuickC verfügt nun über einen eigenen 
Linker, der auf die inkrementale Kompilierung eingeht und 
deshalb im Englischen als »incremental linker« bezeichnet 
wird. Darüber hinaus wird der Linklauf zwar weiterhin von 
der QuickC-Oberfläche aus gestartet, doch wurde von dem 
bisherigen Konzept der »Quick-Library« abgewichen. Da- 
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durch können Programme nun auch innerhalb der QuickC- 
Umgebung unter allen fünf Speichermodellen kompiliert 
und auf alle Funktionen der Laufzeit-Bibliothek zurückge- 
griffen werden, ohne daß dafür eine spezielle Quick-Library 
erstellt werden muß. Der Preis dafür ist eine geringere 
Geschwindigkeit beim Linklauf, doch wird dies durch die 
Geschwindigkeitssteigerungen beim Kompilieren mehr als 
wett gemacht. 

Die Laufzeit-Bibliothek selbst baut auf der Bibliothek 
des großen Microsoft C-Compilers auf und verfügt dement- 
sprechend neben den Standard-Funktionen (zur Ein-/Aus- 
gabe, Speicherverwaltung und Fließkommaarithmetik) auch 
über spezielle »PC-Funktionen« (zum Zugriff auf das DOS 
und BIOS) sowie einen Satz leistungsfähiger Grafikfunktio- 
nen, die alle bekannten Video-Karten von MDA über CGA 
und die Hercules Grafikkarte bis hin zu EGA, VGA und 
MCGA unterstützen. 

Die Laufzeit-Bibliothek des QuickC-Compilers begnügt 
sich damit jedoch nicht, sondern erweitert den Bereich der 
Grafikfunktionen noch um eine Reihe von Funktionen zur 
Erstellung von Präsentationsgrafiken. Mit ihrer Hilfe kann 
der Anwender Balken-, Kuchen-, Linien- und Punktdia- 
gramme erzeugen, ohne sich um die Skalierung der Axen, 
die Zentrierung von Titeln etc. sorgen zu müssen. Mit nur 
wenigen Programmzeilen lassen sich dadurch Grafiken pro- 
grammieren, die bisher nur mit speziell dafür konzipierten 
Programmen erstellt werden konnten. 

Bei der Erstellung derartiger Grafiken greift QuickC 
u.a. auf mehrere Schriftdateien zurück, mit deren Hilfe Zei- 
chen in fast beliebiger Größe auf den Bildschirm gebracht 
werden können. Neben den Schriftmustern »Courier«, 
»Helvetica« und »Times Roman«, die als Bitmuster vorlie- 
gen und daher nur in drei Schriftgrößen ausgegeben werden 
können, sind im Lieferumfang von QuickC auch Schrift- 
dateien für die Schriftmuster »Modern«, »Script« und 
»Roman« enthalten, die vektororientiert aufgebaut sind und 
daher in jeder beliebigen Größe auf den Bildschirm ge- 
bracht werden können. 


Die Make-Utility 


Der Leistungsumfang von QuickC 2.0 zeigt, daß dieses Pro- 
dukt nicht nur für C-Einsteiger, sondern auch für fortge- 
schrittene, wenn nicht gar professionelle Programmierer 
entwickelt wurde. Die aber erstellen häufig große Pro- 
gramme, die der besseren Übersichtlichkeit halber in ein- 
zelne Module aufgeteilt werden (Bild 3). Zwar werden diese 
Module separat kompiliert, doch beim Linklauf zu einem 
einzigen Programm zusammengefügt. Wichtig ist dabei, daß 
alle Module auf dem »neuesten Stand« sind und gerade hier 
schleichen sich schr leicht Fehler ein. 

Wenn beispielsweise mehrere Module auf eine Include- 
Datei zurückgreifen, dann müssen alle diese Module neu 
kompiliert werden, sobald Veränderungen in dieser Datei 
vorgenommen werden, weil diese Veränderungen mögli- 
cherweise die Codegenerierung durch den Compiler beein- 
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Bild 3: Auf dem Bildschirm kann der Anwender mit Hilfe der 
integrierten Make-Utility die Module definieren, aus denen 
sich ein Programm zusammensetzt. 


flussen (z.B. wenn eine Konstante verändert wird, auf die 
innerhalb der verschiedenen Module zugegriffen wird). 

Hier behilft man sich häufig, indem man Abhängigkei- 
ten zwischen verschiedenen Dateien definiert und so z.B. 
festlegt, daß die C-Module x, y und z neu kompiliert wer- 
den müssen, sobald Veränderungen an der Include-Datei h 
vorgenommen werden. Während diese Abhängigkeiten 
normalerweise in einer relativ komplizierten Syntax be- 
schrieben und in einer speziellen Make-Datei zusammen- 
gefaßt werden müssen, macht es QuickC dem Anwender 
hier viel leichter. 

Über einen speziellen Menüpunkt im Hauptmenü 
erlaubt QuickC dem Anwender die Erstellung einer solchen 
Make-Datei und gleichzeitig die Definition aller Dateien, 
die zur Erstellung des jeweiligen Programms von Bedeu- 
tung sind. Will man dieses Programm erstellen, stellt 
QuickC dann automatisch fest, ob und welche Dateien dazu 
neu kompiliert werden müssen und startet anschließend 
automatisch den Linklauf, an dessen Ende das ausführbare 
Programm steht. 


Der Debugger 


Ob man mit QuickC nun große oder kleine Programme 
erstellt - nur selten funktionieren diese Programme auf An- 
hieb einwandfrei und so muß man sich häufig auf die Feh- 
lersuche (Debugging) machen. Die Zeiten, in denen man 
sich dabei mit der Ausgabe bestimmter Informationen wäh- 
rend des Programmablaufs über pr intf-Befehle begnügen 
mußte, sind allerdings längst vorbei und so verfügt auch 
QuickC über einen integrierten Debugger, der die Fehler- 
suche wesentlich erleichtert. 

Er erlaubt die Verfolgung des Programmablaufs auf 
dem Bildschirm, wobei jeweils die aktuell ausgeführte 
Quellzeile im Dateifenster hervorgehoben wird. Nach der 
Ausführung jeder Quellzeile kann der Anwender die Pro- 
grammausführung stoppen, den Inhalt beliebiger Variablen 
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Bild 4: Hier wird während der Programmausführung der 
Inhalt verschiedener Variablen permanent am Bildschirm 
angezeigt. 


betrachten und sogar verändern, um dadurch auf die Pro- 
grammausführung Einfluß zu nehmen (Bild 4). Wem das 
nicht ausreicht, der kann sich am Bildschirm auch gleich die 
Inhalte der verschiedenen Prozessorregister anzeigen lassen 
und so nachvollziehen, wie die einzelnen C-Befehle den 
Inhalt dieser Register verändern. 

Auch das Setzen von Haltepunkten ist möglich, so daß 
die Programmausführung ungestört fortgesetzt wird, bis 
einer der gesetzten Haltepunkte erreicht wird. Besonders 
schwierig zu entdeckende Fehler, wie etwa der Speicherzu- 
griff mit einem nicht initialisierten Zeiger, lassen sich ent- 
decken, indem eine bestimmte Bedingung (beispielsweise 
*ptr == 5) definiert wird, bei deren Eintritt die Pro- 
grammausführung gestoppt wird. 

Wem auch diese Möglichkeiten noch zu begrenzt 
erscheinen, der kann zum Debuggen übrigens jederzeit auf 
CodeView, den Debugger der großen Microsoft-Compiler, 
umsteigen, denn die von QuickC erstellten Dateien können 
von Code View ohne weiteres verarbeitet werden. 


Fazit 


Der QuickC-Compiler erweist sich in der täglichen Praxis 
als zuverlässiges und komfortables Entwicklungswerkzeug, 
das auch zur Realisation großer Projekte herangezogen 
werden kann. Dies wurde auch bei der Erstellung unserer 
SAA-Serie deutlich, die mittlerweile einen Quellcode von 
mehr als 300 Kbyte umfaßt und komplett mit QuickC ent- 
wickelt wurde. Lediglich der Debugger sollte meiner Mei- 
nung nach noch um die Möglichkeit erweitert werden, auch 
den erzeugten Maschinencode anzuzeigen, da dies 
manchmal sehr hilfreich sein kann. Vor allem, wenn man 
Code formuliert, den der Compiler zwar richtig, aber den- 
noch anders interpretiert, als man es selbst getan hätte, er- 
weist sich dies bei der Fehlersuche oft als der einzige Weg 
zum Erfolg. 

Michael Tischer 
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rbon Plus, Version 5.1: 


Der ferngesteuerte Computer 


Ein verzweifelter PC-Benutzer ruft an und fragt 
um Rat, weil sein Programm plötzlich nicht 
mehr macht, was es soll. Ein Programm muß 
neu konfiguriert werden, aber dazu müßte man 
erst zum Standort der Installation fahren. Auf 
einem PC hat jemand versehentlich eine Pro- 
grammdatei gelöscht, weiß aber nicht genau, 
welche, Leider sitzt der unglückliche Benutzer 
300 km entfernt. - Nun sitzt der Experte am 
Telefon und versucht mit viel Mühe, dem oft 
unerfahrenen Benutzer komplizierte DOS- 
Kommandos zu diktieren. Wenn man nur per 
Telefon in den weit entfernten PC hineinschauen 
könnte! 


Man kann. Eine besondere Art von Kommunikationspro- 
grammen macht es möglich, einen PC über eine Telefon- 
leitung fernzusteuern. Die bekanntesten Programme dieser 
Art sind Remote (1979), Carbon Copy, Close-Up (1985), PC 
Anywhere (1986) und Co/Session (1987). Remote existiert 
mittlerweile in den neuen Versionen Remote2 und R2LAN. 
Wir haben die ebenfalls neue Version 5.1 von Carbon Copy 
Plus getestet. 

Beim Fernsteuern werden alle Tastendrücke auf den 
anderen PC übertragen und alle Bildschirmveränderungen 
von diesem zurückgemeldet, so daß der »Helfer« auf sei- 
nem Bildschirm eigentlich den Bildschirm des anderen 
Computers sieht. Zum Übertragen braucht man an jedem 
der beiden PCs ein Modem. Wenn man will, kann man 
Übertragungsfchler automatisch korrigieren lassen. Die 
Fehlerkorrektur verlangsamt allerdings den Prozeß. 

Auf der »Host«-Seite, d.h., auf dem zu beobachtenden 
Computer, muß zuerst ein residentes Programm (CC.EXE, 
52448 Byte) geladen werden. Danach kann der Benutzer 
beliebige Programme ablaufen lassen, sogar Terminal- 
Emulationsprogramme wie IRMA 3270 oder IBM 5250. 
Diese Programme können dann vom zweiten PC, dem 
»Helfer«, ferngesteuert werden. 

Auf dem »Helfer«-PC läuft das Programm 
CCHELP.EXE, das zwar mehr Speicherplatz belegt, sich 
diesen aber nicht mit einem anderen Programm teilen muß. 
CCHELP dient nur zur Fernsteuerung des anderen Compu- 
ters über die Telefonleitung. 


Grafische Bildschirme 


Carbon Copy geht sogar so weit, Grafikbildschirme zu 
übertragen, Dabei wird selbst dann der Bildschirminhalt der 
Gegenstelle angezeigt, wenn diese einen ganz anderen 
Grafikadapter mit einer anderen Auflösung verwendet. Die 
Umsetzung kann zwangsläufig nicht ganz perfekt sein, 
besonders wenn der empfangende PC eine sehr niedrige 
Auflösung hat, aber für viele Zwecke reicht das aus. 
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Remote Operator‘s Dialogue 
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Bild 1: Nach dem Start des »Helfer«-Programms CCHELP 
zeigt sich ein übersichtlich gestalteter Bildschirm mit Hinwei- 
sen zur Funktionstasten-Bedienung. 


Allerdings darf man sich keiner Täuschung darüber hin- 
geben, wie langsam eine solche Übertragung vor sich geht. 
Mit 1200-Baud-Modems ist es bei höheren Auflösungen fast 
unerträglich und mit 300 Baud sollte man es besser gar 
nicht erst versuchen. Mit einem 9600-Baud-Modem ist die 
Geschwindigkeit immer noch lange nicht so, als ob man 
direkt am anderen Computer säße. Das ist selbst bei 38,4 
Kilobaud, der höchsten unterstützten Geschwindigkeit, noch 
nicht der Fall, aber für den Zweck einer längeren Fern- 
wartung sind 9600 Baud sicher sehr erstrebenswert. Man 
merkt hier, daß der Hersteller Meridian Technology eine 
Tochtergesellschaft des Modemherstellers Microcom ist, 
der besonders durch sein fehlerkorrigierendes MNP-Proto- 
koll bekannt wurde. MNP-Modems beschleunigen die 
Datenübertragung durch Datenkompression, was dem Pro- 
gramm Carbon Copy sicher sehr zugute kommt. 


Dateiübertragung mit »CCDOS« 


Was tun, wenn eine Datei fehlt, die man aber schon auf 
dem »Helfer«-Computer hat? Kein Problem, mit Carbon 
Copy kann man auch beliebige Dateien über die Leitung 
schicken. Dazu bietet das Programm einen Arbeitsmodus, 
der den DOS-Prompt simuliert. Dieser Modus heißt 
»CCDOS« und erlaubt die Kommandos ALERT, CHDIR, 
COPY, DEL, DIR, EXIT, MKDIR, PROMPT, REN und 
TYPE. ALERT, das einzige dieser Kommandos, das es in 
DOS nicht gibt, löst einen Warnton aus. Die übrigen funk- 
tionieren genau wie die gleichnamigen DOS-Kommandos. 
Damit man zwischen dem lokalen Laufwerk C (oder A, B, 
usw.) und dem gleichnamigen Laufwerk C auf dem »Host«- 
Computer unterscheiden kann, werden die Laufwerke mit 
LC (lokales C) und HC (Host-C) bezeichnet. Mit dem 
Kommando 
COPY LC:123.CNF HC: 

kann man also die Datei 123.CNF vom eigenen PC auf 
den anderen kopieren. Carbon Copy sendet oder empfängt 
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die gewünschte Datei mit Fehlerkorrektur über die Tele- 
fonleitung. Man kann Dateien sogar übertragen, während 
der Benutzer auf der Host-Seite mit einem beliebigen ande- 
ren Programm arbeitet, weil Carbon Copy die Dateien im 
Hintergrund überträgt. 


Verständigung mit dem Bediener 


Während einer Verbindung kann man jederzeit die Bild- 
schirmanzeige des gerade untersuchten Programms verlas- 
sen und auf ein Carbon-Copy-Menü umschalten. Dort fin- 
det man auch zwei »Chat Windows« (frei übersetzt: Plau- 
der-Fenster), in denen man sich mit dem Bediener der 
Gegenseite in beiden Richtungen per Tastatur verständigen 
kann. Bestimmte Modems können auch von »Daten« auf 
»Sprache« umgeschaltet werden, so daß man zwischendurch 
auch mündlich ein paar Worte wechseln kann. Wenn solche 
Modems verwendet werden, dann stellt Carbon Copy eine 
entsprechende Funktionstaste zum Umschalten von Daten 
auf Sprache und umgekehrt bereit. 

Besondere Beachtung findet das Drucken. Carbon Copy 
kann den Druck zum »Helfer«-Computer umleiten, so daß 
der Helfer auch den Ausdruck direkt prüfen kann. Dabei 
werden Spool-Möglichkeiten bereitgestellt, so daß man 
nicht auf den Drucker warten muß. Carbon Copy kann auch 
auf beiden Computern gleichzeitig drucken. 


Besondere Eigenschaften 


Wer ein Programm wie Carbon Copy lädt und sein Modem 
auf automatische Anrufbeantwortung stellt, der muß damit 
rechnen, daß irgendwann ein Hacker versucht, in seinen 
Computer einzudringen. Zum Schutz dagegen bietet Car- 
bon Copy die Zugangskontrolle durch Paßwort, den auto- 
matischen Rückruf und die Verschlüsselung aller übertra- 
genen Daten. Das Verschlüsseln sichert die Daten nicht nur 
vor Eindringlingen, sondern auch vor dem Abhören an 
beliebiger Stelle im Telefonnetz. 

Carbon Copy enthält einen Leckerbissen für Program- 
mierer. Es ist möglich, einige Funktionen auch von einem 
anderen Programm aus zu steuern oder abzufragen, so daß 
man in bestimmten Programmen die Zusammenarbeit mit 
Carbon Copy schon vorsehen und vorprogrammieren kann. 

Außer der komplizierten Fernsteuerung anderer Pro- 
gramme kann man mit Carbon Copy auch einfache, nor- 
male Kommunikationsaufgaben lösen. Für eine solche 
Terminal-Emulation entlehnt das Programm die meisten 
wichtigen Kommandos aus dem bekannten Kommunikati- 
onsprogramm Crosstalk XVI. Sogar die Script-Sprache wird 
unterstützt. Wie bei Crosstalk XVI reicht jedoch auch diese 
nicht bis zu Mehrfachverzweigungen in Abhängigkeit von 
verschiedenen empfangenen Daten. Carbon Copy emuliert 
eine Reihe populärer Terminals und unterstützt wie Cross- 
talk die File-Transfer-Protokolle Xmodem/Batch, Ymo- 
dem/Batch sowie Kermit im Text- und Binär-Modus. 
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Your Dialogue 


Resote Operator's Dialogue 


CALL CC USER 


Enter Name to Call or Telephone 4 
*[* to enter interactive mode 


se 
for networks, switches 8 unique 
wodens. 


[f3] to redial last number. 
Number: 
Esc to Cancel 


Bild 2: Nach Betätigen der Funktionstaste [F1) verändert sich 
der untere Bereich des Bildschirms zum Eingeben oder Aus- 
wählen der gewünschten Telefonnummer. 


Eine »Schnappschuß«-Taste (Alt-W) ermöglicht es, 
jederzeit den Bildschirminhalt in eine Datei zu speichern, 
z.B. um ihn später zu analysieren oder vorzuführen. 


Probleme 


Das beste Programm nützt nichts, wenn es nicht geladen ist. 
Wenn man Ferndiagnosen unerwartet auftretender Fehler 
mit Carbon Copy durchführen will, dann muß man dafür 
sorgen, daß das Programm immer »auf Verdacht« geladen 
1st. 

Ein Problem kann auftreten, wenn das ferngesteuerte 
Programm selbst versucht, den verwendeten Kommunika- 
tionsanschluß zu benutzen oder zurückzusetzen. Das Hand- 
buch warnt z.B. ausdrücklich vor Lotus Symphony. Beim 
Test zeigte sich jedoch, daß Carbon Copy den COM-An- 
schluß sehr wirksam vor dem Zugriff anderer Programme 
schützt. Es hatte mit Symphony trotz installierttem COM- 
Treiber keine Probleme. Der DOS-Befehl MODE zeigte 
an, daß der COM-Anschluß gar nicht mehr vorhanden 
wäre. Natürlich kann das ferngesteuerte Programm den 
Anschluß dann auch nicht benutzen. 

Programme, die einen eigenen Tastaturtreiber verwen- 
den, können möglicherweise nicht mit Carbon Copy fernge- 
steuert werden. Wir waren nicht in der Lage, Microsoft 
Windows mit Carbon Copy Plus (Foreign Keyboard Ver- 
sion) fernzusteuern. Allerdings wäre es wegen seiner grafi- 
schen Arbeitsweise und der damit verbundenen großen 
Bildschirm-Datenmengen auch etwas vermessen, dieses 
über eine Telefonleitung bedienen zu wollen. 

Da Carbon Copy auf der Host-Seite immer als residen- 
tes Programm geladen werden muß, sind die üblichen Kon- 
flikte mit anderen, konkurrierenden TSR-Routinen oder 
mit anderweitig empfindlichen Programmen zu erwarten. 
Bei unseren Tests mit einer kleinen Auswahl verschiedener 
Programme traten keine Schwierigkeiten auf. Man sollte 
sich jedoch vor dem Kauf davon überzeugen, daß Carbon 
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Softwaretest 


Copy mit den geplanten fernzusteuernden Programmen ver- 
träglich ist. 

Noch eine besondere Falle wartet auf den arglosen 
Käufer. Klein und unauffällig steht auf dem Buchrücken des 
Handbuches die Notiz: »TWO COPIES REQUIRED«. 
Wer das Programm nur einmal kauft, dieses mit derselben 
Seriennummer auf zwei PCs installiert und dann versucht, 
die beiden PCs zu verbinden, der ist hineingetappt. Carbon 
Copy prüft die Seriennummer der Gegenstelle und weigert 
sich zu arbeiten, wenn diese mit der eigenen übereinstimmt. 

Hiervon abgesehen hat Carbon Copy keinen Kopier- 
schutz. Bei der Erstinstallation muß lediglich der Firmen- 
name des Benutzers eingegeben werden, der dann im 
Lotus-Stil in das Programm »eingebrannt« wird. Er läßt 
sich nie wieder entfernen und wird bei jedem Programm- 
start angezeigt. Die Lizenz untersagt nur die gleichzeitige 
Benutzung des Programms auf mehreren Computern. 

Das Handbuch ist gut gegliedert und vermittelt in knap- 
pem Stil die notwendigen Informationen, allerdings, ebenso 
wie das Programm selber, in englischer Sprache. Insgesamt 
macht das Programm Carbon Copy Plus einen soliden Ein- 
druck. Besonders die leistungsfähige Behandlung von Gra- 
fikbildschirmen verdient Anerkennung. 


Weitere Einsatzmöglichkeiten 


Die Einsatzmöglichkeiten eines Programms wie Carbon 
Copy gehen weit über die hier geschilderte Fernwartung, 
Fernbetreuung und Ferndiagnose hinaus. Carbon Copy 
kann z.B. als eine preiswerte Alternative zum Anschluß 
einer Terminal-Emulation an einen Großrechner verwendet 
werden, besonders wenn diese nur gelegentlich gebraucht 
wird. Dazu schließt man vor Ort an den Großrechner einen 
PC mit Terminal-Emulation an, lädt auf diesem aber 
gleichzeitig das Carbon Copy Host-Programm. Dann kön- 
nen mehrere andere PCs reihum über das Telefonnetz auf 
diesen zugreifen und auf diese Weise am Großrechner 
arbeiten, ohne selbst einen teuren Anschluß zu benötigen. 
Andere Möglichkeiten beruhen darauf, Carbon Copy 
auf einem PC ablaufen zu lassen, der in ein Local Area 
Network (LAN) eingebunden ist. Dadurch haben andere, 
räumlich entfernte PCs die Möglichkeit, auf die Ressourcen 
des LAN und seiner Server, z.B. auch Kommunikations- 
server, zuzugreifen, ohne über teure Brücken oder Gate- 
ways an dieses angeschlossen sein zu müssen. Ein weiterer 
Vorteil dieser Arbeitsweise ist, daß auf diesem Wege oft 
nicht ganze Dateien gelesen und über das LAN übertragen 
werden müssen, sondern nur die Informationen der Bild- 
schirme, die der Fern-Benutzer tatsächlich schen will. Dies 
kann erheblich rationeller sein als ein LAN-Anschluß. 
Sicher werden in der nächsten Zukunft noch viele weitere 
interessante und nützliche Verwendungen für den 
»ferngesteuerten PC« gefunden werden. 
Hans-Georg Michna 
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MS-DOS, MS-Windows, MS-0$/2 sowie Presentation-Manager sind eingetragene Warenzeichen der Fa. MicroSoft Inc. 


Ein Maximum an Information auf wenig Raum: Schnellübersichten 
e kompakt ® praxisgerecht ® problemorientiert 
e übersichtlich ® zeitsparend 


Stemer 


Valentin 


p | Makroprogrummlerdl 


BE N 


R. Valentin 

Works 

1988, 433 Seiten 

ISBN 3-89090-688-5 

DM 39,- (sFr 35,90/6S 304,-) 


R. Valentin/). Steiner 
Framework Il 

1988, 474 Seiten 

ISBN 3-89090-683-4 

DM 39,- (sFr 35,90/6S 304,-) 


R. Valentin/J. Steiner 
Framework Ill 

1988, 448 Seiten 

ISBN 3-89090-733-4 

DM 39,- (sFr 35,90/6S 304,-) 


RA. Valentir 


Fred - EROSION m 


IS sBr  3-89C 190.734-2 

DM 39,- (sFr 35,90/6S 304,- 
J. Hückstädt/J. Steiner 
Turbo Basic 

1988, 396 Seiten 

ISBN 3-89090-713-X 

DM 39,- (sFr 35,90/6S 304, - 
J. Steiner 

Turbo Pascal 5.0 

1989, 436 Seiten 

ISBN 3-89090-631-1 

DM 39,- (sFr 35,90/65 304,- 


J. Hückstädt 

QuickBasic 4.0 

1989, 416 Seiten 

ISBN 3-89090-721-0 

DM 39,- (sFr 35,90/6S 304,-) 


K. Löffelmann 

GFA-Basic 3.0 für Atari ST 
1989, 328 Seiten 

ISBN 3-89090-740-7 

DM 39,- (sFr 35,90/8S 304,-) 


J. Hückstädt 
BasicA und GW-Basic 
1989, 286 Seiten 

ISBN 3-89090-722-9 
DM 39,- (sFr 35,90/6 


P.Wollschlaeger 
Amiga-Basic 

1989, 299 Seiten 

ISBN 3-89090-736-9 

DM 39,- (sFr 35,90/6S 304,-) 


M.Borges/F. Anders/Th. Behrendorf 
Clipper 

1989, 390 Seiten 

ISBN 3-89090-741-5 

DM 39,- (sFr 35,90/6S 304,-) 


J. Steiner 

dBase Ill (Plus) 

1988, 404 Seiten 

ISBN 3-89090-564-1 

DM 39,- (sFr 35,90/6S 304 


Markt&Technik 


Markt&Technik ge A, N Hans-Pinsel-Straße 2, 8013 Haar bei München, Telefon (089) 46 13-0 


J. Steiner/R.Valentin 

Lotus 1-2-3 Version 2 

1988, 316 Seiten 

ISBN 3-89090-562-5 

DM 34,90 (sFr 32,10/6S 272,- 


J.Steiner/R, Valentin 
Multiplan 3.0 

1988, 308 Seiten 

ISBN 3-89090-568-4 

DM 34,90 (sFr 32,10/6S 272 
J. Steiner/A, Valentin 


Microsoft Word 4.0 
1988, 4 = 


B.JJ.S.Siepmann 


G.Jürgensmeier/J. Steiner 
PC-/MS-DOS ab Version 3 
1988, 453 Seiten 

ISBN 3-89090-567-6 

DM 39,- (sFr 35,90/6S 304 


) 


